Eine Ansicht stellt eine Datentabelle in Looker dar. Diese Tabelle kann entweder in Ihrer Datenbank vorhanden sein oder mit der Looker-Funktion abgeleitete Tabelle erstellt worden sein. Ansichten werden in der Regel in Ansichtsdateien deklariert, wobei jede Datei eine Ansicht enthält.
Jede Ansicht enthält Felddefinitionen, die in der Regel einer Spalte in der zugrunde liegenden Tabelle oder einer Berechnung in Looker entsprechen. Diese Felder werden in der Feldreferenz, der Referenz für Dimensionstypen und der Referenz für Messwerttypen beschrieben.
Außerdem gibt es eine Reihe von Einstellungen auf Ansichtsebene, die auf dieser Seite beschrieben werden.
Nutzungsbeispiel
Bewegen Sie den Mauszeiger auf einen Parameternamen, um eine Kurzbeschreibung aufzurufen. Klicken Sie auf einen Parameter, um die zugehörige Referenzseite aufzurufen. Wenn ein Parameter auf eine von mehreren bestimmten Optionen festgelegt werden kann, wird der Standardwert zuerst aufgeführt.
## STRUCTURAL PARAMETERS include:"filename_or_pattern" ## Possibly more include declarations test: test_name{ explore_source: explore_name { # Desired subparameters (described ontestpage) } assert: assert_statement { expression:Looker expression ;; } # Possibly more assert declarations } ## Possibly more test declarations view: view_name { extension: required extends: [view_name, view_name, ...] (dimension | dimension_group | measure | filter):field_name{ # Desired field parameters (described on Field Parameters page) } # Possibly more field declarations set: set_name{ fields:[field_or_set, field_or_set, ...] } # Possibly more set declarations drill_fields: [field_or_set, field_or_set, ...] # DISPLAY PARAMETERS label: "desired label" fields_hidden_by_default: yes | no # FILTER PARAMETERS suggestions: yes | no # QUERY PARAMETERS autogenerate_primary_keys: yes | no required_access_grants: [access_grant_name, access_grant_name, ...] sql_table_name: table_name ;; # DERIVED TABLE PARAMETERS derived_table: { cluster_keys: ["column_name", "column_name", ...] create_process: { sql_step:SQL query ;; } datagroup_trigger: datagroup_name distribution: "column_name" distribution_style: all | even explore_source: explore_name { # Desired subparameters (described onexplore_sourcepage) } increment_key: "column_name" increment_offset: N indexes: ["column_name", "column_name", ...] interval_trigger: "N (seconds | minutes | hours)" materialized_view: yes | no partition_keys: ["column_name", "column_name", ...] persist_for: "N (seconds | minutes | hours)" publish_as_db_view: yes | no sortkeys: ["column_name","column_name", ...] sql: SQL query ;; sql_create: { SQL query ;; } sql_trigger_value: SQL query ;; table_compression: GZIP | SNAPPY table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE } } ## REFINEMENT PARAMETERS view: +view_name { final: yes }
Parameterdefinitionen
| Parametername | Beschreibung |
|---|---|
| Strukturparameter | |
drill_fields (für Ansicht) |
Gibt die Standardliste der Felder an, die beim Aufschlüsseln von Messwerten angezeigt werden, die in der Ansicht definiert sind. |
extends (für Ansicht) |
Gibt die Ansicht(en) an, die durch diese Ansicht erweitert werden |
extension (für Ansicht) |
Gibt an, dass für die Ansicht eine Erweiterung erforderlich ist und sie selbst nicht für Nutzer verfügbar gemacht werden kann. |
include |
Fügt einer Ansicht Dateien hinzu. |
test |
Erstellt einen Datentest zur Prüfung der Logik Ihres Modells. Die Projekteinstellungen enthalten eine Option zum Erfordern von Datentests. Wenn diese Option für ein Projekt aktiviert ist, müssen Entwickler für das Projekt Datentests durchführen, bevor sie ihre Änderungen in der Produktion implementieren. Dieser Parameter enthält die Unterparameter explore_source und assert. |
set |
Definiert einen Satz von Dimensionen und Messwerten, die in anderen Parametern verwendet werden sollen. |
view |
Erstellt eine Ansicht |
| Parameter für die Anzeige | |
label (für Ansicht) |
Gibt an, wie der Ansichtsname im Field Picker angezeigt wird |
fields_hidden_by_default |
Hinzugefügt: 21.12.
Wenn auf yes festgelegt, werden standardmäßig alle Felder in der Ansicht ausgeblendet. Verwenden Sie den Parameter hidden: no für ein Feld, um das Feld anzuzeigen. |
| Filterparameter | |
suggestions (für Ansicht) |
Aktiviert oder deaktiviert Vorschläge für alle Dimensionen in dieser Ansicht |
| Suchparameter | |
autogenerate_primary_keys (für Ansicht) |
Aktiviert oder deaktiviert die automatische Generierung von Primärschlüsseln. |
required_access_grants (für Ansicht) |
Beschränkt den Zugriff auf die Ansicht auf die Nutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
sql_table_name (für Ansicht) |
Ändert die SQL-Tabelle, auf der eine Ansicht basiert |
| Parameter für abgeleitete Tabellen | |
cluster_keys |
Gibt an, dass eine PDT nach einem oder mehreren Feldern in BigQuery gruppiert wird
Unterstützung für cluster_keys in Snowflake hinzugefügt |
create_process |
Gibt eine geordnete Abfolge von Schritten zum Erstellen einer PDT in einem Datenbankdialekt an, der benutzerdefinierte DDL-Befehle erfordert. Dieser Parameter hat den Unterparameter sql_step.
|
datagroup_trigger |
Gibt die Datengruppe, die für die Richtlinie zur Neuerstellung von PDTs verwendet werden soll |
derived_table |
Erstellt eine Ansicht auf Grundlage einer abgeleiteten Tabelle |
distribution |
Legt den Verteilungsschlüssel einer PDT fest, die in Redshift oder Aster erstellt wird |
distribution_style |
Legt den Verteilungsstil einer PDT fest, die in Redshift erstellt wird |
explore_source |
Definiert eine native abgeleitete Tabelle basierend auf einem Explore |
increment_key |
Hinzugefügt in Version 21.4
Wandelt die abgeleitete Tabelle in eine inkrementelle PDT um. Der Parameter increment_key gibt das Zeitinkrement an, in dem neue Daten abgefragt und an die PDT angehängt werden sollen. |
increment_offset |
Hinzugefügt in Version 21.4
Wird in Verbindung mit dem Parameter increment_key für inkrementelle PDTs verwendet. Der Parameter increment_offset gibt die Anzahl vorheriger Zeiträume an (in der Granularität des Inkrementschlüssels), die neu erstellt werden, um spät eintreffende Daten zu berücksichtigen. |
interval_trigger |
Hinzugefügt: 21.20
Mit interval_trigger wird ein Zeitplan für die Neuerstellung einer persistenten abgeleiteten Tabelle im Format "N (seconds | minutes | hours)" angegeben. |
materialized_view |
Hinzugefügt am 21.10.
Mit der Anweisung materialized_view: yes wird eine materialisierte Ansicht für eine abgeleitete Tabelle in Ihrer Datenbank erstellt. |
indexes |
Legt die Indizes einer PDT fest, die in einer herkömmlichen Datenbank erstellt wurde (z. B. MySQL, Postgres), bzw. eines überlappenden Sortierschlüssels in Redshift |
partition_keys |
Gibt an, dass eine PDT durch ein oder mehrere Felder in Presto oder durch ein einzelnes Datums-/Zeitfeld in BigQuery partitioniert wird |
persist_for (für derived_table) |
Legt das maximale Alter einer PDT fest, bevor diese regeneriert wird. |
publish_as_db_view |
Mit der Anweisung publish_as_db_view: yes wird eine stabile Datenbankansicht für die PDT erstellt, damit die Tabelle außerhalb von Looker abgefragt werden kann. |
sortkeys |
Legt die Sortierschlüssel für eine PDT fest, die in Redshift erstellt wird |
sql (für derived_table) |
Deklariert die SQL-Abfrage für eine abgeleitete Tabelle |
sql_create |
Definiert eine SQL CREATE-Anweisung zum Erstellen einer PDT in einem Datenbankdialekt, der benutzerdefinierte DDL-Befehle erfordert |
sql_trigger_value |
Gibt die Bedingung an, die dazu führt, dass eine PDT neu erstellt wird |
table_compression |
Gibt die Tabellenkomprimierung für eine PDT in Amazon Athena an |
table_format |
Gibt das Tabellenformat für eine PDT in Amazon Athena an |
| Parameter für die Verfeinerung | |
view: +view_name |
Fügt ein Pluszeichen (+) vor einem vorhandenen Ansichtsnamen ein, um der vorhandenen Ansicht eine Verfeinerung hinzuzufügen. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Verfeinerungen. |
final |
Gibt an, dass die aktuelle Verfeinerung die letzte zulässige Verfeinerung für die Ansicht ist. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite LookML-Verfeinerungen. |
| Unzulässige Parameter | |
distkey |
Entfernt: 3.26
Ersetzt durch distribution |
view_label |
Avoid 4.4
Ersetzt durch label |