Eine Ansicht stellt eine Datentabelle in Looker dar. Dabei spielt es keine Rolle, ob die Tabelle in Ihre Datenbank integriert oder mit der Funktion für abgeleitete Tabellen von Looker erstellt wurde. 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 Dimensionstypreferenz und der Messwerttypreferenz 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 zu sehen. 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, ...] # CUSTOM CALENDAR PARAMETERS calendar_definition: { Custom calendar mapping parameters ;; } # 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_analytic_model: { sql: analytic_model_definition ;; } sql_analytic_model_name: analytic_model_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 in der Ansicht definierten Messwerten angezeigt werden |
extends (für Ansicht) |
Gibt die Ansichten an, die durch diese Ansicht erweitert werden |
extension (für Ansicht) |
Gibt an, dass die Ansicht eine Erweiterung erfordert und 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, die Datentests vorschreibt. 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 hat 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 |
| Anzeigeparameter | |
label (für Ansicht) |
Legt fest, wie der Ansichtsname in der Feldauswahl angezeigt wird |
fields_hidden_by_default |
Hinzugefügt in Version 21.12
Wenn auf yes gesetzt, werden standardmäßig alle Felder in der Ansicht ausgeblendet. Verwenden Sie den hidden: no Parameter für ein Feld, um es 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 an, die für die Richtlinie zur Neuerstellung von PDTs verwendet werden soll |
derived_table |
Basiert eine Ansicht auf 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, die auf einem Explore basiert |
increment_key |
Hinzugefügt in Version 21.4
Macht die abgeleitete Tabelle zu einer inkrementellen PDT. Mit increment_key wird das Zeitinkrement angegeben, für das neue Daten abgefragt und an die PDT angehängt werden sollen. |
increment_offset |
Hinzugefügt in Version 21.4
Wird in Verbindung mit dem increment_key Parameter für inkrementelle PDTs verwendet. Mit increment_offset wird die Anzahl vorheriger Zeiträume angegeben (in der Granularität des Inkrementschlüssels), die neu erstellt werden, um spät eintreffende Daten zu berücksichtigen. |
interval_trigger |
Hinzugefügt in Version 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 in Version 21.10
Mit der Anweisung materialized_view: yes wird eine materialisierte Ansicht in Ihrer Datenbank für eine abgeleitete Tabelle erstellt. |
indexes |
Legt die Indizes einer PDT fest, die in einer herkömmlichen Datenbank erstellt wurde (z. B. MySQL, Postgres) oder einen überlappenden Sortierschlüssel 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 neu erstellt 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, um eine PDT in einem Datenbankdialekt zu erstellen, 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 Verfeinerungen | |
view: +view_name |
Fügt vor einem vorhandenen Ansichtsnamen ein Pluszeichen (+) ein, um der vorhandenen Ansicht eine Verfeinerung hinzuzufügen. Weitere Informationen und Anwendungsfälle finden Sie auf der Dokumentationsseite zu 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 zu LookML-Verfeinerungen. |
| Unzulässige Parameter | |
distkey |
Entfernt in Version 21.26
Ersetzt durch distribution |
view_label |
Vermeiden in Version 21.4
Ersetzt durch label |