Parameter ansehen

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 on test page)
  }
  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 on explore_source page)
    }
    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