Parameter ansehen

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 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, ...]

  # 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 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 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