Übersicht
LookML ist die Sprache, in der Looker Dimensionen, Aggregate, Berechnungen und Datenbeziehungen in einer SQL-Datenbank beschreibt und SQL-Abfragen für diese Datenbank erstellt. Empfohlene Schritte für das Lernen von LookML finden Sie auf der Dokumentationsseite LookML lernen.
Auf dieser Referenzseite können Sie schnell die LookML-Parameter identifizieren, die Sie benötigen, um die gewünschten Datenmodellierungseffekte zu erzielen. Diese Referenz kann außerdem hilfreich sein, um die Funktionen der einzelnen Parameter eines vorhandenen Modells kennenzulernen. Sie können auch die einzelnen Referenzseiten für die entsprechenden LookML-Strukturen aufrufen: model, view, Explore, join, manifest oder fields.
Eine Einführung in diese LookML-Strukturen und ihre Beziehung zueinander finden Sie auf der Dokumentationsseite zu LookML-Begriffen und -Konzepten. Unten auf dieser Seite finden Sie Links zu zusätzlichen Ressourcen, mit denen Sie LookML-Elemente identifizieren, verstehen und implementieren können.
Anleitung für den Umgang mit dieser Referenz
Auf dieser Seite sind Parameter nach den verschiedenen Funktionen sortiert, die diese ausführen können, sowie nach den verschiedenen Effekten, die Sie damit erzielen können.
Die Tabelleneinträge in den verschiedenen Abschnitten enthalten Folgendes:
Parametername | Stufe | Beschreibung |
---|---|---|
Name und Link zur Hauptdokumentationsseite des Parameters | Ebene, auf der der Parameter angewendet wird, mit einem Link zu einer Liste aller anderen auf dieser Ebene verfügbaren Parameter: Modell, Ansicht, Erkunden, Join, Manifest oder Felder. Einige Parameter können in LookML auf mehreren Ebenen verwendet werden. | Kurzbeschreibung der Funktion des Parameters und ob er Unterparameter enthalten kann |
Einige Parameter auf Feldebene können mit mehreren Feldtypen verwendet werden. Daher markieren wir auf dieser Seite alle Parameter auf Feldebene mit Symbolen, die die Feldtypen angeben, mit denen diese verwendet werden können. Sie können den Mauszeiger auf das Symbol verschieben, um dessen Namen anzuzeigen. Alternativ können Sie auf das Symbol klicken, um die Referenzseite für diesen Feldtyp aufzurufen.
Strukturparameter
Diese LookML-Parameter wirken sich auf die Struktur eines Projekts oder dessen zugrunde liegende Dateien aus.
Wichtige Strukturparameter in einem Modell oder einer Explore-Datei
Wie auf der Dokumentationsseite zu LookML-Begriffen und -Konzepten zu sehen ist, enthält ein Projekt eine oder mehrere Modelldateien, die Parameter zum Definieren eines Modells und dessen explorativen Datenanalysen und Joins verwenden.
In diesem Abschnitt werden die wichtigsten Strukturparameter beschrieben, die Sie typischerweise in eine Modelldatei eingeben. Diese dienen als Rahmen für alle anderen Parameter. Ein explore
-Parameter wird normalerweise auf der obersten Ebene einer Modelldatei definiert. Wenn Sie jedoch eine native abgeleitete Tabelle verwenden, kann er in einer Erkundungsdatei definiert werden.
Parametername | Stufe | Beschreibung |
---|---|---|
explore |
Modell | Zeigt eine Ansicht im Menü „Explore“ an. Weitere Informationen zu „Erkunden“ und ihren Parametern finden Sie auf der Referenzseite zu Parametern ansehen. Wirkt sich auf Name und Menü entdecken aus. Für diesen Parameter sind viele Unterparameter auf der Referenzseite Parameter untersuchen und an anderer Stelle auf dieser Seite aufgeführt. |
fields |
Entdecken | Beschränkt die verfügbaren Felder in einem Tab „Erkunden“ in der Basisansicht und über die Joins von „Erkunden“. Wirkt sich auf die Felder in der Feldauswahl aus. |
include |
Modell | Fügt einem Modell Dateien hinzu. Dieser Parameter kann auch in Ansichtsdateien für native abgeleitete Tabellen verwendet werden. |
join |
Teilnehmen | Verbindet eine zusätzliche Ansicht mit einem Explore. Weitere Informationen finden Sie unten im Abschnitt Teilnehmende Ansichten. |
test |
Modell | Erstellt einen Datentest, um die Logik Ihres Modells zu überprüfen. In den Projekteinstellungen ist die Option Datentests erforderlich enthalten. 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 . |
Wichtige Strukturparameter in einer Ansichtsdatei
Wie auf der Dokumentationsseite zu LookML-Begriffen und -Konzepten dargestellt, enthält ein Projekt eine oder mehrere Ansichtsdateien, die Parameter zum Definieren dieser Ansicht, ihrer Felder (einschließlich Dimensionen und Messwerte) und ihrer Felder verwenden.
Dieser Abschnitt beschreibt die wichtigsten Strukturparameter, die Sie typischerweise in eine Ansichtsdatei eingeben.
Parametername | Stufe | Beschreibung |
---|---|---|
dimension
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Dimensionsfeld. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
dimension_group
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt mehrere zeitbasierte Dimensionen gleichzeitig. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
fields |
Teilnehmen | Bestimmt, welche Felder aus einem Join zu einem Explore hinzugefügt werden sollen. |
measure
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Messwertfeld. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
view |
Modell (wird aber in der Ansichtsdatei verwendet) | Erstellt eine Ansicht. Wirkt sich auf das Standardverhalten der Feldauswahl aus. Bei diesem Parameter sind viele Unterparameter auf der Referenzseite Parameter anzeigen und an anderer Stelle auf der aktuellen Seite aufgeführt. |
Hilfreiche Strukturparameter
Diese Parameter helfen Ihnen, das gewünschte strukturelle Verhalten zu definieren. Beispielsweise ermöglichen sie Ihnen die Angabe von Feldern, das Hinzufügen spezifischer Dateien (und deren Inhalt), die Wiederverwendung von Definitionen usw.
Parametername | Stufe | Beschreibung |
---|---|---|
+ (Suchfilter) |
Erkunden und Ansehen | Mit LookML-Verfeinerungen können Sie die LookML von Ansichten und Explores in Ihren Projekten erweitern. |
constant |
Manifest | Definiert eine LookML-Konstante, die dann in einem Projekt eingesetzt werden kann. Dieser Parameter hat die Unterparameter value und export . |
extends |
Erkunden und Ansehen | Verwendet die Definition eines anderen LookML-Objekts wieder und fügt dabei Unterparameter nach Bedarf hinzu oder überschreiben sie. Dieser Parameter kann auch mit LookML-Dashboards verwendet werden. |
extension |
Erkunden und Ansehen | Gibt an, dass ein Explore, eine Ansicht oder ein Dashboard nicht direkt verwendet werden kann. Stattdessen ist die Definition als Vorlage für andere Objekte gedacht, die auf diesem Objekt Erweiterungen verwenden. Dieser Parameter kann auch mit Dashboards verwendet werden. |
include |
Modell | Fügt einem Modell Dateien hinzu. Dieser Parameter kann auch in Ansichtsdateien für native abgeleitete Tabellen verwendet werden. |
intervals
|
Felder: DG | Sie können die gewünschten Dimensionsdimensionen in einer dimension_group für Dimensionsgruppen festlegen, die als type: duration konfiguriert sind. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
local_dependency |
Manifest | Gibt ein oder mehrere Projekte an, die Dateien enthalten, die Sie einschließen möchten. |
parameter
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Nur-Filter-Feld, mit dem Nutzer Eingaben in einem Liquid-{% parameter %} -Tag vornehmen können. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
project_name |
Manifest | Gibt den Namen des aktuellen Projekts an |
remote_dependency |
Manifest | Gibt ein oder mehrere Remote-Repositorys an, die Dateien enthalten, die Sie einschließen möchten |
set |
Ansicht | Definiert einen Satz von Dimensionen und Messwerten, die in anderen Parametern verwendet werden sollen. Mit diesem Parameter können die Felder begrenzt werden, die für einen Join und damit die Feldauswahl verfügbar sind. Mit diesem Parameter kann auch festgelegt werden, welche Felder angezeigt werden sollen, wenn ein Nutzer in die Daten gelangt. Dieser Parameter hat den Unterparameter fields . |
timeframes
|
Felder: DG | Definiert die Zeitraumdimensionen, die Sie in einer dimension_group für Dimensionsgruppen wünschen, die als type: time konfiguriert sind. Wirkt sich auf das Standardverhalten der Feldauswahl aus. |
Extension Framework-Anwendungen
Looker-Entwickler können dem Extension Framework von Looker eine Anwendung hinzufügen, indem sie den Parameter application
in der Manifestdatei eines Projekts verwenden. Nachdem eine Erweiterung zu einem Projekt hinzugefügt wurde, können Looker-Nutzer mit den entsprechenden Berechtigungen die Erweiterung im Menü Suchen von Looker sehen.
Wenn Ihr Administrator die Labs-Funktion für Erweiterte Navigation aktiviert hat, werden die Erweiterungen im neuen Navigationsbereich links unter Anwendungen aufgeführt.
Parametername | Stufe | Beschreibung |
---|---|---|
application |
Manifest | Fügt dem Projekt eine Anwendung mithilfe des Extension Framework von Looker hinzu. Dieser Parameter hat Unterparameter, die auf der Dokumentationsseite zum Parameter application beschrieben sind. |
Explore-Name und -Menü
Der Name eines Explore und dessen Darstellung im Menü „Explore“ hilft Ihren Benutzern, den für ihre Bedürfnisse richtigen Explore auszuwählen. Diese LookML-Parameter wirken sich auf das Standardverhalten für den Namen und die Darstellung des Bereichs „Erkunden“ im Menü „Erkunden“ aus.
Weitere Informationen finden Sie im Abschnitt Name und Menü für „Erkunden“ auf der Dokumentationsseite Menü für „Erkunden“ und „Feld auswählen“ ändern.
Standardverhalten
Das Standardverhalten für den Namen eines explorativen Analysetools und dessen Darstellung im Menü „Erkunden“ wird durch die unten aufgeführten Parameter festgelegt.
Parametername | Stufe | Beschreibung |
---|---|---|
explore |
Modell | Zeigt eine Ansicht im Menü „Explore“ an. Weitere Informationen zu „Erkunden“ und ihren Parametern finden Sie auf der Referenzseite zu Parametern ansehen. Wirkt sich auf Name und Menü entdecken aus. |
Explore-Namen und -Menü ändern
Der Explore-Name und seine Darstellung im Menü „Explore“ kann mithilfe der Parameter in der folgenden Tabelle geändert werden.
Parametername | Stufe | Beschreibung |
---|---|---|
description |
Entdecken | Fügt eine Beschreibung für einen Explore hinzu, die Benutzern auf der Seite „Explore“ und im gleichnamigen Menü angezeigt wird. |
group_label |
Entdecken | Erstellt eine Bezeichnung, die als Überschrift im Menü „Explore“ verwendet werden soll. |
hidden |
Entdecken | Blendet einen Explore im Menü „Explore“ aus. |
label |
Entdecken | Ändert die Darstellung eines Explore im Menü „Explore“. |
label |
Modell | Ändert die Darstellung eines Modells im Menü „Explore“. |
Field Picker
Die Organisation und die Anzeigenamen der Ansichten und Felder im Field Picker können Benutzern dabei helfen, Visualisierungen zu verstehen und die Felder zu finden, die sie in Explores benötigen. Diese LookML-Parameter wirken sich auf das Standardverhalten für Inhalt, Darstellung und Organisation der Feldauswahl aus.
Weitere Informationen finden Sie im Abschnitt Feldauswahl auf der Dokumentationsseite Menü „Erkunden“ und Feldauswahl ändern.
Standardverhalten
Das standardmäßige Aussehen und Verhalten des Field Picker wird durch die unten aufgeführten Parameter festgelegt. Eine vollständige Erläuterung dieses Standardverhaltens finden Sie im Abschnitt Feldauswahl auf der Dokumentationsseite Menü „Erkunden“ und Feldauswahl ändern.
Parametername | Stufe | Beschreibung |
---|---|---|
dimension
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Dimensionsfeld |
dimension_group
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt mehrere zeitbasierte Dimensionen gleichzeitig |
filter
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein reines Filterfeld für die Verwendung in einem Vorlagenfilter oder einem bedingten Join |
measure
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Messwertfeld |
parameter
|
Ansicht (aber auf der Feldreferenzseite aufgeführt) | Erstellt ein Nur-Filter-Feld, mit dem Nutzer Eingaben in einem Liquid-{% parameter %} -Tag vornehmen können |
timeframes
|
Felder: DG | Definiert die Zeitraumdimensionen, die Sie in einer dimension_group für Dimensionsgruppen als type: time konfigurieren möchten. |
intervals
|
Felder: DG | Definiert die gewünschten Dimensionen für die Dauer in dimension_group für Dimensionsgruppen, die als type: duration konfiguriert sind |
view |
Modell (aber auf der Referenzseite ansehen) | Erstellt eine Ansicht |
Ansichtsnamen im Field Picker ändern
Anhand des Anzeigenamens einer Datenansicht können Nutzer die Felder, die sie benötigen, besser in „Erkunden“ finden. Wenn der Ansichtsname in einer Visualisierung angezeigt wird, können Sie durch die Änderung der Darstellung des Namens das Verständnis der Visualisierung verbessern. In diesem Abschnitt werden die LookML-Parameter beschrieben, die sich auf die Anzeigenamen im Field Picker auswirken. Eine ausführliche Erläuterung dieses Themas finden Sie im Abschnitt Feldauswahl auf der Seite Ändern des Menüs „Erkunden“ und der Feldauswahl.
Parametername | Stufe | Beschreibung |
---|---|---|
label |
Ansicht | Gibt an, wie der Ansichtsname in der Feldauswahl angezeigt wird |
view_label |
Entdecken | Gibt an, wie eine Gruppe von Feldern aus der Basisansicht des Tabs in der Feldauswahl bezeichnet wird |
view_label |
Teilnehmen | Ändert die Darstellung des Ansichtsnamens des Joins in der Feldauswahl |
Feldlisten im Field Picker ändern
Eine Änderung der Vorgehensweise zur Auflistung von Feldern kann Ihren Benutzern helfen, Visualisierungen zu verstehen und die Felder zu lokalisieren, die sie für ihre Explores benötigen. Die im Field Picker aufgeführten Ansichtsnamen können mit den Parametern in der folgenden Tabelle geändert werden. Eine ausführliche Erläuterung dieses Themas finden Sie im Abschnitt Feldauswahl auf der Seite Ändern des Menüs „Erkunden“ und der Feldauswahl.
Parametername | Stufe | Beschreibung |
---|---|---|
description
|
Felder: D DG M F P | Fügt eine Beschreibung zum Feld hinzu, die Benutzern angezeigt wird, wenn sie mit der Maus auf das Feld zeigen |
fields |
Entdecken | Beschränkt die verfügbaren Felder in einem Tab „Erkunden“ in der Basisansicht und über die Joins von „Erkunden“. Wirkt sich auf die Felder in der Feldauswahl aus. |
fields |
Teilnehmen | Bestimmt, welche Felder aus einem Join zu einem Explore hinzugefügt werden sollen. |
hidden
|
Felder: D DG M F P | Blendet ein Feld in der Explore-Benutzeroberfläche aus |
label
|
Felder: D DG M F P | Ändert die Darstellung eines Feldnamens in der Feldauswahl |
label_from_parameter
|
Felder: D M | Ändert die Darstellung eines Feldnamens in einer Visualisierung basierend auf der Eingabe für einen parameter |
Die Organisation von Feldern im Field Picker ändern
Die Organisation der Felder hilft Ihren Benutzern, die Felder zu lokalisieren, die sie für Explores benötigen. Die Organisation der Felder im Field Picker kann durch die Parameter in der folgenden Tabelle geändert werden. Eine ausführliche Erläuterung dieses Themas finden Sie im Abschnitt Feldauswahl auf der Seite Ändern des Menüs „Erkunden“ und der Feldauswahl.
Parametername | Stufe | Beschreibung |
---|---|---|
group_label
|
Felder: D DG M F | Felder in einer Ansicht der Feldauswahl gruppieren |
view_label
|
Felder: D DG M F P | Ändert die Felder, die in einer Ansicht in der Feldauswahl angezeigt werden |
Lokalisierung
Wenn Sie Ihr Modell lokalisieren, können Sie mithilfe der Parameter für die Standorteinstellungen die Anzeige der Labels und Beschreibungen in der Looker-Benutzeroberfläche basierend auf der Sprache des Nutzers anpassen. Informationen zum Einrichten Ihres Modells für die Lokalisierung finden Sie auf der Dokumentationsseite Modelllokalisierung.
Parametername | Stufe | Beschreibung |
---|---|---|
localization_settings |
Manifest | Gibt Sie die Lokalisierungsinformationen für Ihr Modell an. Dieser Parameter hat die Unterparameter default_locale und localization_level . |
localization_level |
Manifest | Gibt an, ob Zeichenfolgen ohne Übersetzung in Ihrem Modell zulässig sind |
default_locale |
Manifest | Gibt das Gebietsschema an, das als Standard für die Übersetzung von Strings Ihres Modells verwendet wird |
Datenwerte und Datenanzeige
Wenn Sie die Werte und die Darstellung der Daten im Abschnitt Daten einer explorativen Datenanalyse ändern, können Nutzer die Ergebnisse besser verstehen. Wenn Sie die Datentypen für Ihre Dimensionen oder Messwerte ändern oder einschränken möchten, ändern Sie das Format der Ihren Benutzern angezeigten Daten, geben Sie die fehlenden Werte ein oder ändern Sie andere Visualisierungsoptionen.
Nutzer können auch ihre eigenen Tabellenberechnungen im Bereich „Daten“ definieren. Dimensionen und Messwerte sollten jedoch nach Möglichkeit in LookML definiert werden. In diesem Fall wird die korrekte Berechnung einmalig durchgeführt und anschließend konsistent in nachfolgenden Abfragen verwendet.
Datenwerte für mehrere Feldtypen
Mit diesen Parametern können Sie Datenwerte für mehrere Feldtypen ändern.
Parametername | Stufe | Beschreibung |
---|---|---|
case
|
Felder: D M | Erstellt einen diskreten Satz von Werten, den eine Dimension haben kann, bestimmt durch SQL-Bedingungen. Dieser Parameter hat die Unterparameter when und else . |
sql
|
Felder: D DG M F | Legt die Berechnungsmethode für ein Feld fest |
type (für Dimension, Filter oder Parameter)
|
Felder: D F P | Gibt den Typ der Dimension, des Filters oder des Parameters an |
type (für Dimensionsgruppe)
|
Felder: DG | Gibt den Typ der Dimensionsgruppe an |
type (für Messung)
|
Felder: M | Gibt den Typ des Messwerts an |
Datenwerte für bestimmte Dimensionstypen
Sie können die Datenwerte für einige Dimensionstypen mit typspezifischen Parametern ändern.
Dimensionen von type: date
oder type: datetime
Parametername | Stufe | Beschreibung |
---|---|---|
convert_tz
|
Felder: D DG F M P | Deaktiviert die automatische Zeitzonenumwandlung für das Feld |
datatype
|
Felder: D DG F M | Gibt den Typ der Zeitdaten an, die für das Feld bereitgestellt werden |
fiscal_month_offset |
Modell | Gibt den Monat an, in dem Ihr Geschäftsjahr beginnt (falls es vom Kalenderjahr abweicht) |
week_start_day |
Modell | Gibt den Wochentag an, an dem die wochenbezogenen Dimensionen beginnen sollen |
Abmessungen von type: distance
Parametername | Stufe | Beschreibung |
---|---|---|
end_location_field
|
Felder: D | Definiert das Feld, das den Endstandort für ein Feld von type: distance enthält. Dieser Parameter wird auch als Strukturparameter betrachtet. |
start_location_field
|
Felder: D | Definiert das Feld, das die Startposition für ein Feld von type: distance enthält |
units
|
Felder: D | Gibt die zu verwendende Einheit für Felder von type: distance an |
Abmessungen von type: location
Parametername | Stufe | Beschreibung |
---|---|---|
sql_latitude
|
Felder: D | Definiert den Breitengrad einer Dimension von type: location . |
sql_longitude
|
Felder: D | Definiert den Längengrad einer Dimension von type: location . |
Abmessungen von type: string
Parametername | Stufe | Beschreibung |
---|---|---|
string_datatype
|
Felder: D | Gibt den Unicode-Datentyp für die Dimension type: string für SQL Server oder MySQL an |
Abmessungen von type: tier
Parametername | Stufe | Beschreibung |
---|---|---|
tiers
|
Felder: D | Definiert die Stufen für eine Dimension von type: tier |
Dimensionsgruppen von type: duration
oder Dimensionen von type: duration_x
Parametername | Stufe | Beschreibung |
---|---|---|
sql_start
|
Felder: D DG | Definiert die Startzeit einer Dauer für eine Dimensionsgruppe von type: duration oder eine Dimension von type: duration_x |
sql_end
|
Felder: D DG | Definiert die Endzeit einer Dauer für eine Dimensionsgruppe von type: duration oder eine Dimension von type: duration_x |
Datenwerte für Messwerte
Die meisten Parameter sind auf bestimmte Messwerttypen beschränkt, wie in der Tabelle angegeben. Weitere Informationen zum Erstellen einer Anzahl, die nach einem Dimensionswert gefiltert ist, finden Sie unter Anzahl nach einer Dimension filtern. Informationen zum Erstellen eines Messwerts, der den Prozentsatz zwischen zwei Feldern berechnet, finden Sie unter Prozentsätze.
Parametername | Stufe | Beschreibung |
---|---|---|
approximate |
Felder: M | Führt die ungefähre Schätzung für Messungen von type: count_distinct durch. Auf der Seite zu approximate finden Sie eine Liste der Dialekte, die diesen Parameter unterstützen. |
approximate_threshold
|
Felder: M | Legt die Anzahl von Messwerten fest, bei der BigQuery von einer genauen Anzahl zu einer ungefähren Anzahl wechseln soll |
direction
|
Felder: M | Bestimmt die Richtung, in der Messwerte von type: percent_of_total oder type: running_total berechnet werden, wenn Pivots verwendet werden. |
list_field
|
Felder: M | Gibt die Dimension an, aus der ein Messwert von type: list berechnet werden soll. Dieser Parameter wird auch als Strukturparameter betrachtet. |
percentile
|
Felder: M | Gibt den Bruchwert (das n-te Perzentil) für ein Maß von type: percentile oder type: percentile_distinct an |
primary_key
|
Felder: D | Deklariert eine Dimension als Primärschlüssel einer Ansicht |
sql_distinct_key
|
Felder: M | Definiert die einzelnen Elemente, für die ein bestimmter Messwert wie type: sum_distinct oder type: average_distinct berechnet wird. |
symmetric_aggregates |
Entdecken | Gibt an, ob für einen Explore die Funktion für symmetrische Summen aktiviert ist Dieser Parameter wird auch für Parameter aufgeführt, die das Verhalten eines Join beeinflussen. Weitere Informationen finden Sie unten im Abschnitt Teilnehmende Ansichten. |
Datenformate
Sie können die Lesbarkeit von Datenwerten für Ihre Benutzer verbessern, indem Sie die Daten anhand der Parameter in der folgenden Tabelle formatieren.
Parametername | Stufe | Beschreibung |
---|---|---|
html
|
Felder: D DG M | Ändert die HTML-Ausgabe eines Feldes mithilfe von Liquid-Vorlagen |
named_value_format |
Modell | Erstellt ein benutzerdefiniertes Wertformat zur Verwendung mit value_format_name . Dieser Parameter hat die Unterparameter value_format und strict_value_format . |
style
|
Felder: D | Ändert die Darstellung von Ebenen in der Looker-Benutzeroberfläche für eine Dimension von type: tier |
value_format
|
Felder: D M | Formatiert die Ausgabe eines Feldes mithilfe von Excel-Stiloptionen |
value_format_name
|
Felder: D M | Formatiert die Ausgabe eines Feldes mithilfe eines integrierten oder benutzerdefinierten Formats |
Datensortierung und -eingabe
Bei den meisten Feldern ist die Sortierreihenfolge unkompliziert – es handelt sich einfach um eine alphanumerische Sortierung der Werte. In einigen Fällen kann es sinnvoll sein, die Ergebnisse einer neuen LookML-Anweisung case
oder einer alten LookML-sql_case
in einer bestimmten Reihenfolge zu sortieren. Sie können die Werte auch nach dem Wert eines anderen Felds sortieren lassen. Mit dem Parameter allow_fill
können Sie auch zulassen oder verhindern, dass Nutzer Looker bitten, für ein Feld fehlende Datumsangaben und Werte auszufüllen.
Parametername | Stufe | Beschreibung |
---|---|---|
allow_fill
|
Felder: D DG | Legt fest, ob die Dimensionsfüllung für eine Dimension zulässig ist |
alpha_sort
|
Felder: D | Die Parameter eines case -Parameters werden alphabetisch sortiert.
|
order_by_field
|
Felder: D DG | Sortiert ein Feld anhand der Werte eines anderen Feldes Unterstützt für Dimensionsgruppen |
Standortdaten visualisieren
Looker bietet eine Vielzahl von Karten, die Sie zur Visualisierung von Standortdatenwerten im Abschnitt Visualisierung zur Verfügung stellen können. Sie können auch benutzerdefinierte Karten für Visualisierungen erstellen und verwenden.
Parametername | Stufe | Beschreibung |
---|---|---|
map_layer |
Modell | Erstellt benutzerdefinierte Karten zur Verwendung mit map_layer_name . Dieser Parameter enthält viele Unterparameter auf der Seite map_layer . |
map_layer_name
|
Felder: D | Gibt eine Zuordnung von einem Datenwert zu einer geografischen Region an, die Sie auf einer integrierten oder benutzerdefinierten Karte definiert haben. |
Anklickbare Aktionen für Datenwerte
Aufschlüsselung
In Looker kann jedes Suchergebnis als Ausgangspunkt für eine weitere Suche dienen. Nutzer können auf einen Datenwert klicken, um die Daten aufzurufen. Sie können auch mit LookML festlegen, welche Felder angezeigt werden sollen, wenn ein Benutzer die Daten aufschlüsselt. Dimensionen und Messwerte haben beim Bohren unterschiedliche Standardeinstellungen.
Weitere Informationen zum Erstellen benutzerdefinierter Aufschlüsselungspfade finden Sie im Artikel Leistungsstärkere Datenbohrungen in der Hilfe.
Parametername | Stufe | Beschreibung |
---|---|---|
drill_fields
|
Felder: D DG M | Deklariert die Liste der Felder, die angezeigt werden sollen, wenn ein Messwert oder eine Dimension aufgeschlüsselt wird |
set |
Ansicht | Definiert einen Satz von Dimensionen und Messwerten, die in anderen Parametern verwendet werden sollen. Dieser Parameter kann verwendet werden, um die Felder einzuschränken, die für einen Join und folglich für den Field Picker verfügbar sind. Dieser Parameter kann auch für die Definition der Felder verwendet werden, die angezeigt werden sollen, wenn ein Benutzer Daten aufschlüsselt. Weitere Informationen finden Sie auf der Dokumentationsseite Grundlagen von LookML unter Sets für Aufschlüsselungsdetails. |
Datenaktionen
Manchmal kann es erforderlich sein, dass Ihre Benutzer nach Anzeige der Daten Ereignisse auslösen müssen. Wenn Sie den Aktions-Hub von Looker verwenden, können Sie festlegen, dass Felder mit bestimmten tags
bestimmte integrierte Dienste verwenden können. Sie können Datenaktionen auch verwenden, um festzulegen, welche Optionen den Benutzern für ein Feld zur Verfügung stehen.
Parametername | Stufe | Beschreibung |
---|---|---|
action
|
Felder: D M | Erstellt eine Datenaktion in einem Feld, mit der Benutzer direkt über Looker Aufgaben in anderen Tools durchführen können. Dieser Parameter enthält viele Unterparameter auf der Seite action . |
tags
|
Felder: D DG M F P | Fügt Text hinzu, der an andere Anwendungen weitergeleitet werden kann, um Daten zu einem Feld bereitzustellen |
Wird verknüpft
Sie können Ihren Benutzern ermöglichen, mit einem Klick auf einen Datenwert die zugehörige URL aufzurufen. Mit diesen Parametern können Sie angeben, welche Felder angezeigt werden, wenn der Nutzer eine Aufschlüsselung der Daten ausführt. Außerdem können Sie den anzuzeigenden Text, die Ziel-URL und ein Favicon für die Zielwebsite angeben.
Parametername | Stufe | Beschreibung |
---|---|---|
link
|
Felder: D M | Erstellt Links zu anderen Looker- und externen Inhalten. Dieser Parameter hat die Unterparameter label , url und icon_url . Informationen zu erweiterten Optionen mit link finden Sie auch im Artikel Leistungsstärkere Datenaufschlüsselung in der Hilfe. |
Wird gefiltert
Nutzer können in explorativen Datenanalysen, Looks und Dashboards Filter auf ihre Abfragen anwenden.
Sie können die Nutzerfreundlichkeit verbessern, indem Sie das Filterverhalten direkt in LookML festlegen und z. B. hilfreiche Filter hinzufügen oder dafür sorgen, dass sie nicht versehentlich eine Abfrage erstellen, die Ihre Datenbankressourcen zu stark beansprucht. Sie können Filterverhalten wie Groß- und Kleinschreibung, Standardwerte sowie die Filtervorschläge festlegen, die Looker während der Eingabe generieren kann.
Weitere Informationen zum Filtern in LookML finden Sie auf der Dokumentationsseite zu zusätzlichen LookML-Grundlagen unter Ergebnissätze filtern. Informationen zu erweiterten Optionen bei Verwendung von Vorlagenfiltern erhalten Sie in der Rich Media-Hilfe in den Artikeln zu Vorlagen für Filter und Liquid-Parameter und Vorlagen für erweiterte Vorlagen.
Eine vollständige Liste der Filterausdrücke und der Syntax finden Sie auf der Dokumentationsseite zu Looker-Filterausdrücken.
Erforderliche Filter mit festen Werten
Im Folgenden werden die Parameter zur Angabe von Filtern aufgeführt, die standardmäßig verwendet werden:
Weitere Informationen finden Sie auf der Dokumentationsseite Grundlagen von LookML unter Anzahl nach Dimensionen filtern.
Parametername | Stufe | Beschreibung |
---|---|---|
access_filter |
Entdecken | Fügt einem Explore benutzerspezifische Filter hinzu. Dieser Parameter hat die Unterparameter field und user_attribute . |
sql_always_having |
Entdecken | Fügt Bedingungen in die HAVING -Klausel der Abfrage ein, die ein Nutzer für diese Erkundung nicht ändern oder entfernen kann |
sql_always_where |
Entdecken | Fügt Bedingungen in die WHERE -Klausel der Abfrage ein, die ein Nutzer für diese Erkundung nicht ändern oder entfernen kann |
sql_where |
Teilnehmen | Wenn dieser Join in die Abfrage einbezogen wird, werden Bedingungen in die WHERE -Klausel der Abfrage eingefügt, die ein Nutzer für diese Erkundung nicht ändern oder entfernen kann. Nur für BigQuery. Dieser Parameter kann auch als Filterparameter betrachtet werden. |
Erforderliche Filter mit veränderbaren Werten
Mit diesen Parametern können Sie Filter angeben, die verwendet werden müssen, wobei der Nutzer die Werte der Filter ändern darf.
Parametername | Stufe | Beschreibung |
---|---|---|
always_filter |
Entdecken | Fügt einem Explore Filter hinzu, die Benutzer ändern, aber nicht entfernen können. Dieser Parameter hat den Unterparameter filters . |
filter
|
Felder: F | Erstellt ein reines Filterfeld für die Verwendung in einem Vorlagenfilter |
filters
|
Felder: M | Beschränkt die Berechnung eines Messwerts anhand von Dimensionsbeschränkungen |
Filter verhindern
Mit diesen Parametern können Sie verhindern, dass ein Benutzer ein Feld als Filter verwendet. Dabei kann diese Auswahl grundsätzlich oder bei Aufschlüsselungen angewendet werden.
Parametername | Stufe | Beschreibung |
---|---|---|
can_filter
|
Felder: D DG M | Bestimmt, ob eine Dimension oder ein Messwert als Filter verwendet werden kann |
skip_drill_filter
|
Felder: D | Verhindert, dass eine Dimension im Rahmen der Aufschlüsselung eines Messwerts zu den Filtern hinzugefügt wird |
Bedingte Filter
Manchmal kann es erforderlich sein, dass ein Benutzer einen von mehreren Filtern verwendet, um seine Abfrage einzuschränken. Ein Benutzer muss beispielsweise eine Suchabfrage anhand des Datums oder der Region einschränken.
Zusätzlich zum Parameter unten finden Sie auf der Dokumentationsseite Zusätzliche LookML-Grundlagen auch Ergebnisfilter filtern.
Parametername | Stufe | Beschreibung |
---|---|---|
conditionally_filter |
Entdecken | Fügt einem Explore Filter hinzu, wenn ein Benutzer keinen eigenen Filter aus einer spezifischen Liste hinzufügt. Dieser Parameter hat die Unterparameter filters und unless . |
Verhalten der Filterwerte
Um den Filtervorgang für Ihre Benutzer zu erleichtern, können Sie einen Standardwert für den Filter angeben oder festlegen, dass bei Filterwerten die Groß-/Kleinschreibung beachtet werden soll.
Parametername | Stufe | Beschreibung |
---|---|---|
case_sensitive |
Entdecken | Gibt an, ob bei Filtern für einen Explore zwischen Groß- und Kleinschreibung unterschieden werden soll |
case_sensitive
|
Felder: D F | Gibt an, ob bei Filtern für eine Dimension zwischen Groß- und Kleinschreibung unterschieden werden soll |
case_sensitive |
Modell | Gibt an, ob bei Filtern für ein Modell zwischen Groß- und Kleinschreibung unterschieden werden soll |
default_value
|
Felder: F P | Gibt einen Standardwert für Filterfelder an |
Filtervorschläge
Filtervorschläge sind eine gute Möglichkeit, Ihre Benutzer bei der Filterung von Daten zu unterstützen. In einigen Fällen kann es sinnvoll sein, Vorschläge zu deaktivieren oder das Vorschlagsverhalten zu ändern.
Diese LookML-Parameter beeinflussen das Standardverhalten für Filtervorschläge.
Standardverhalten
Standardmäßig basieren die Looker-Vorschläge für ein bestimmtes Filterfeld auf allen eindeutigen Werten in den Daten dieses Felds.
Vorschläge aktivieren oder deaktivieren
Wenn Sie der Meinung sind, dass ein Feld eine sehr große Anzahl von eindeutigen Werten aufweist, kann es sinnvoll sein, Filtervorschläge für dieses Feld zu deaktivieren. Dadurch wird vermieden, dass der Benutzer zu viele Vorschläge prüfen und die Datenbank diese Vorschläge bereitstellen muss. Sie können Filtervorschläge auf mehreren Ebenen aktivieren oder deaktivieren.
Parametername | Stufe | Beschreibung |
---|---|---|
suggestable
|
Felder: D DG M F P | Aktiviert oder deaktiviert Vorschläge für ein Feld |
suggestions |
Ansicht | Aktiviert oder deaktiviert Vorschläge für alle Dimensionen in dieser Ansicht |
Vorgeschlagene Werte
Standardmäßig generiert Looker Filtervorschläge auf Basis der eindeutigen Werte eines Felds. In einigen Fällen sind die Vorschläge möglicherweise hilfreicher, wenn Sie festgelegt haben, welche Werte von Looker vorgeschlagen werden sollen, wie zum Beispiel die wahrscheinlichsten Werte. Wenn Sie den Zugriff auf einige Werte in den Daten außerdem einschränken, können Sie festlegen, ob diese Einschränkungen auch auf die Vorschläge angewendet werden sollen.
Parametername | Stufe | Beschreibung |
---|---|---|
allowed_value
|
Felder: P | Gibt die Optionen für parameter an. Dieser Parameter hat die Unterparameter label und value . |
bypass_suggest_restrictions
|
Felder: D DG F P | Wenn Nutzer sql_always_where verwenden, werden Vorschläge angezeigt, die Limits werden aber nicht auf die Vorschläge angewendet |
full_suggestions
|
Felder: D DG F P | Wenn Nutzer sql_always_where verwenden, werden Vorschläge angezeigt und diese Beschränkungen werden auf die Vorschläge angewendet |
suggest_dimension
|
Felder: D DG M F P | Gibt die Vorschläge für ein Feld basierend auf den Werten einer anderen Dimension an |
suggest_explore
|
Felder: D DG M F P | Gibt die Vorschläge für ein Feld basierend auf den Werten eines anderen Explore an |
suggestions
|
Felder: D F P | Gibt eine Liste von Werten an, die für die Vorschläge eines Felds verwendet werden |
Vorschläge zwischenspeichern
Standardmäßig generiert Looker Filtervorschläge auf Basis der eindeutigen Werte eines Felds. Diese Werte werden für eine bessere Performance zwischengespeichert – Sie können aber den Zeitraum für die Verwendung der zwischengespeicherten Werte ändern. Wenn die Daten relativ stabil sind, sollten Sie einen längeren Zeitraum in Betracht ziehen, um die Leistung beim Abrufen der vorgeschlagenen Werte zu verbessern.
Parametername | Stufe | Beschreibung |
---|---|---|
suggest_persist_for
|
Felder: D F P | Ändert die Cache-Einstellungen für Looker-Filtervorschläge |
Ansichten verbinden
Wie unter Mit Joins in LookML arbeiten erläutert, können Sie Daten aus mehreren Ansichten gleichzeitig untersuchen. Sie können verschiedene Ansichten „verbinden“, damit Benutzer erkennen können, wie diese Daten miteinander zusammenhängen.
Joins werden in der Modelldatei definiert, um die Beziehung zwischen Erkunden und Ansicht herzustellen. Joins verknüpfen eine oder mehrere Ansichten in einem einzelnen Explore, entweder direkt oder über eine andere verbundene Ansicht.
Mit diesen LookML-Parametern können Sie Joins erstellen und festlegen, wie diese funktionieren.
Verbindungselemente
Es gibt eine Vielzahl von Parametern, die festlegen, welche Ansichten standardmäßig oder in bestimmten Situationen verbunden werden. Darüber hinaus können Sie festlegen, welche Felder zu einem Join hinzugefügt werden sollen.
Parametername | Stufe | Beschreibung |
---|---|---|
always_join |
Entdecken | Gibt an, welche Joins immer auf einen Explore angewendet werden müssen |
fields |
Teilnehmen | Bestimmt, welche Felder aus einem Join zu einem Explore hinzugefügt werden sollen. |
from |
Teilnehmen | Gibt die Ansicht an, auf der ein Join basieren soll |
include |
Modell | Fügt einem Modell Dateien hinzu. Nur Ansichten in Dateien, die im Modell verfügbar sind, können für Joins verwendet werden. |
join |
Entdecken | Verbindet eine zusätzliche Ansicht mit einem Explore. Weitere Informationen zu Joins und ihren Parametern finden Sie auf der Referenzseite zu Join-Parametern. Dieser Parameter enthält zahlreiche Unterparameter, die an anderer Stelle auf der aktuellen Seite aufgeführt sind. |
required_joins |
Teilnehmen | Gibt an, welche Joins auf einen Explore angewendet werden sollen, wenn Felder aus einem bestimmten Join ausgewählt werden |
sql_table_name |
Teilnehmen | Gibt die Datenbanktabelle an, auf der ein Join basieren soll |
Vorgehensweise bei Joins
Sie können die Vorgehensweise zum Verbinden verschiedener Ansichten und die Bedingung für den Join-Vorgang festlegen. Sie sollten auch einen Primärschlüssel angeben, damit Looker symmetrische Aggregate verwenden kann, um die korrekten Ergebnisse für Aggregatfunktionen bereitzustellen.
Weitere Informationen zu symmetrischen Aggregaten finden Sie auch in den Hilfeartikeln Eine einfache Erklärung von symmetrischen Aggregaten oder „Warum sieht mein SQL so aus?“ und Das Problem von SQL-Fanouts.
Parametername | Stufe | Beschreibung |
---|---|---|
foreign_key |
Teilnehmen | Gibt eine Beziehung zwischen „Erkunden“ und „Join“ mithilfe des Primärschlüssels der verbundenen Ansicht an |
outer_only |
Teilnehmen | Gibt an, ob alle Abfragen einen äußeren Join verwenden müssen |
primary_key
|
Felder: D | Deklariert eine Dimension als Primärschlüssel einer Ansicht |
relationship |
Teilnehmen | Deklariert, ob ein Join eine 1:1-Beziehung, n:1-Beziehung, 1:n-Beziehung oder n:n-Beziehung aufweist |
sql_on |
Teilnehmen | Gibt eine Beziehung zwischen einem Explore und einem Join an, indem Sie eine SQL-ON -Klausel schreiben |
symmetric_aggregates |
Entdecken | Gibt an, ob für einen Explore die Funktion für symmetrische Summen aktiviert ist Dieser Parameter wird auch für Parameter aufgeführt, die Messwerte beeinflussen. |
type |
Teilnehmen | Deklariert, ob es sich bei einem Join um einen linksseitigen, vollständigen, internen oder typübergreifenden Join handelt |
Caching
Looker reduziert die Belastung Ihrer Datenbank und erhöht die Leistung, indem zwischengespeicherte Ergebnisse früherer Abfragen verwendet werden (sofern verfügbar), die gemäß Ihrer Cache-Richtlinie zulässig sind. Darüber hinaus haben Sie die Möglichkeit, komplexe Abfragen als persistente abgeleitete Tabellen (Persistent Derived Tables, PDTs) zu erstellen, in denen die entsprechenden Ergebnisse gespeichert werden, um spätere Abfragen zu vereinfachen. Bei der Planung des Cachings sollten Sie sowohl die Leistung als auch die Aktualität der Daten für Ihre Nutzer berücksichtigen.
Abfragen zwischenspeichern
Mithilfe von Datengruppen können Sie Looker noch stärker in die ETL-Phase Ihrer Datenpipeline integrieren. Wenn Sie beispielsweise Daten im Rahmen eines nächtlichen ETL-Jobs in einem Stapel laden, können Sie Looker so konfigurieren, dass der Abschluss des ETL-Jobs erkannt wird und alle zugehörigen zwischengespeicherten Abfragen gelöscht werden.
Weitere Informationen finden Sie auf der Dokumentationsseite Caching-Abfragen und Neuerstellung von PDTs mit Datengruppen.
Parametername | Stufe | Beschreibung |
---|---|---|
datagroup |
Modell | Erstellt eine Cache-Richtlinie für Datengruppen für das betreffende Modell. Dieser Parameter hat die Unterparameter max_cache_age , sql_trigger , label und description . |
persist_for |
Entdecken | Ändert die Cache-Einstellungen für einen Explore. Erwägen Sie dabei die Verwendung der umfangreichen Funktionen von Datengruppenparametern. |
persist_for |
Modell | Ändert die Cache-Einstellungen für ein Modell Erwägen Sie dabei die Verwendung der umfangreichen Funktionen von Datengruppenparametern. |
persist_with |
Entdecken | Gibt die Datengruppe an, die für die Caching-Richtlinie des Explore verwendet werden soll |
persist_with |
Modell | Gibt die Datengruppe an, die für die Caching-Richtlinie des Modells verwendet werden soll |
Filtervorschläge zwischenspeichern
Standardmäßig generiert Looker Filtervorschläge auf Basis der eindeutigen Werte eines Felds. Diese Werte werden für eine bessere Performance zwischengespeichert – Sie können aber den Zeitraum für die Verwendung der zwischengespeicherten Werte ändern. Wenn die Daten relativ konstant sind, sollten Sie einen längeren Zeitraum für die Zwischenspeicherung in Betracht ziehen, um die Leistung beim Abrufen der vorgeschlagenen Werte zu verbessern.
Parametername | Stufe | Beschreibung |
---|---|---|
suggest_persist_for
|
Felder: D F P | Ändert die Cache-Einstellungen für Looker-Filtervorschläge |
Für persistente abgeleitete Tabellen zwischenspeichern
Parameter für das Caching für persistente abgeleitete Tabellen finden Sie unten im Abschnitt Parameter für nichtflüchtige abgeleitete Tabellen und Caching speichern.
Abgeleitete Tabellen
Wie in der Anleitung Abgeleitete Tabellen in Looker erläutert, sind abgeleitete Tabellen wichtige Tools in Looker. Sie ermöglichen es Ihnen, neue Tabellen zu erstellen, die noch nicht in Ihrer Datenbank vorhanden sind, die Analysen Ihrer Daten zu erweitern und die Abfrageleistung zu verbessern.
Weitere Informationen finden Sie auf der Dokumentationsseite zu Begriffen und Konzepten von LookML unter Abgeleitete Tabellen und Faktentabellen und Dauerhafte abgeleitete Tabellen.
Strukturparameter für alle abgeleiteten Tabellen
Abgeleitete Tabellen können mit SQL oder LookML definiert werden. Alle abgeleiteten Tabellen beginnen mit diesem Parameter:
Parametername | Stufe | Beschreibung |
---|---|---|
derived_table |
Ansicht | Erstellt eine Ansicht auf Grundlage einer abgeleiteten Tabelle Bei diesem Parameter sind viele Unterparameter an anderer Stelle auf der aktuellen Seite aufgeführt und werden in der Beispieltabelle auf der Dokumentationsseite Parameter ansehen aufgeführt. |
Strukturparameter für native abgeleitete Tabellen
Native abgeleitete Tabellen sind bei der Modellierung Ihrer Daten viel einfacher zu lesen, zu verstehen und zu verstehen.
Die Parameter der nachstehenden Tabelle werden zur Definition der Quelldaten für eine native abgeleitete Tabelle verwendet. Sie werden ausführlicher beschrieben und sind beispielhaft auf der Seite mit der Parameterdokumentation für den explore_source
-Parameter dargestellt.
Parametername | Stufe | Beschreibung |
---|---|---|
bind_all_filters |
Ansicht | Verwenden Sie unter explore_source , um alle Filter aus der Abfrageabfrage an die native abgeleitete Tabellenunterabfrage zu übergeben. Ein Beispiel finden Sie auf der Dokumentationsseite zum Parameter explore_source .
HINWEIS: Der Parameter explore_source kann den Unterparameter bind_all_filters oder den Parameter bind_filters haben, aber nicht beides.
|
bind_filters |
Ansicht | Verwenden Sie unter explore_source , um einen Filter aus der Abfrage „Erkunden“ an die Unterabfrage der nativen abgeleiteten Tabelle zu übergeben. Verwenden Sie den Unterparameter from_field , um ein Feld anzugeben, das in der nativen abgeleiteten Tabellenansicht definiert oder in der Ansicht, mit der die native abgeleitete Tabelle verknüpft ist, zugänglich ist. Während der Laufzeit werden alle Filter für from_field in der Funktion „Erkunden“ in der nativen abgeleiteten Tabellenabfrage an to_field übergeben. Ein Beispiel finden Sie auf der Dokumentationsseite zum Parameter explore_source .
HINWEIS: Der Parameter explore_source kann den Unterparameter bind_all_filters oder den Parameter bind_filters haben, aber nicht beides.
|
column |
Ansicht | Verwenden Sie unter explore_source , um eine Spalte anzugeben, die in der Tabelle enthalten sein soll. Dieser Parameter hat den Unterparameter field . |
derived_column |
Ansicht | Gibt eine Spalte im explore_source mit einem Ausdruck im Namespace der inneren Spalten an. Aggregierte SQL-Ausdrücke funktionieren an dieser Stelle nicht, da in diesem Schritt keine SQL-Gruppierung durchgeführt wird. Dies ist besonders nützlich bei der Definition der Fensterfunktionen (sofern zutreffend). Dieser Parameter hat den Unterparameter sql . |
explore_source |
Ansicht | Erzeugt einen SQL-Code für eine abgeleitete Tabelle basierend auf dem zugehörigen Explore. explore_source enthält verschiedene Unterparameter, die in den anderen Zeilen dieser Tabelle und auf der zugehörigen Dokumentationsseite beschrieben sind. |
expression_custom_filter |
Ansicht | Gibt einen benutzerdefinierten Filterausdruck für eine explore_source -Abfrage an. Optional. |
filters |
Ansicht | Gibt einen benutzerdefinierten Filterausdruck für eine explore_source -Abfrage an. Optional. |
include |
Modell | Enthält die Datei(en), die die Felder enthält, auf die in der Tabelle verwiesen wird, wie auf der Dokumentationsseite zu explore_source erläutert. Weitere Informationen finden Sie in der Dokumentationsseite des include -Parameters. Hier erfahren Sie mehr über weitere Anwendungsfälle wie das Hinzufügen von Dateien zu Modellen und Ansichten. Weitere Informationen zur Verwendung von include zum Erstellen von Joins finden Sie oben im Abschnitt Join-Ansichten. |
limit |
Ansicht | Gibt die Zeilenbegrenzung der Abfrage an. Optional. |
sorts |
Ansicht | Optional. Gibt eine Sortierung für diese explore_source an. Setzen Sie in den eckigen Klammern den Feldnamen, gefolgt von : , und geben Sie dann an, ob das Feld mit dem Keyword asc oder desc in aufsteigender oder absteigender Reihenfolge sortiert werden soll. |
timezone |
Ansicht | Legt die Zeitzone für die Abfrage explore_source fest. Legen Sie für sitzungsspezifische (nicht persistente) abgeleitete Tabellen diesen Parameter auf query_timezone fest, um automatisch die Zeitzone der aktuell ausgeführten Abfrage zu verwenden. Wenn keine Zeitzone angegeben ist, führt die explore_source -Abfrage standardmäßig keine Konvertierung in die Zeitzone durch und wird in der Zeitzone der Datenbank ausgeführt. |
Strukturparameter für abgeleitete SQL-Tabellen
Verwenden Sie für Tabellen, die mittels eine SQL-Codes abgeleitet werden, den unten aufgeführten Parameter.
Parametername | Stufe | Beschreibung |
---|---|---|
sql (für abgeleitete Tabelle) |
Ansicht | Deklariert die SQL-Abfrage für eine abgeleitete Tabelle |
Strukturparameter für benutzerdefinierte Datendefinition
Verwenden Sie bei Datenbankdialekten, die eine benutzerdefinierte Datendefinitionssprache (Data Definition Language, DDL) erfordern, die unten aufgeführten Parameter. Wenn der Datenbankdialekt beispielsweise CREATE TABLE as SELECT
nicht als einzelne SQL-Anweisung unterstützt, verwenden Sie den Parameter create_process
, um ein PDT in mehreren Schritten zu erstellen:
Parametername | Stufe | Beschreibung |
---|---|---|
create_process |
Ansicht | Legt eine Reihe von SQL-Anweisungen fest, die nacheinander in der angegebenen Reihenfolge ausgeführt werden sollen. Jede einzelne SQL-Anweisung wird mit dem Unterparameter sql_step angegeben. |
sql_create |
Ansicht | Definiert eine SQL CREATE -Anweisung zum Erstellen eines PDT für einen Datenbankdialekt, für den benutzerdefinierte DDL-Befehle erforderlich sind |
Parameter zur Regeneration und Zwischenspeicherung für persistente abgeleitete Tabellen
Wie im Abschnitt Caching oben beschrieben, können Sie Datengruppen verwenden, um Ihr Caching zu verwalten und die Effizienz mit der Datenaktualität auszugleichen.
Mit Datengruppen können Sie persistente abgeleitete Tabellen (PDTs) regenerieren, wenn aktuelle Daten verfügbar werden. Alternativ können Sie festlegen, ob PDTs in unregelmäßigen Abständen neu erstellt werden sollen. Die zugrunde liegenden Tabellen werden jedoch regelmäßig aktualisiert; dadurch können Abfragen für PDTs länger zwischengespeichert werden.
Weitere Informationen finden Sie auf der Dokumentationsseite Abgeleitete Tabellen in Looker unter Persistenzstrategien und auf der Dokumentationsseite Caching-Abfragen und Neuerstellung von PDTs mit Datengruppen.
Parametername | Stufe | Beschreibung |
---|---|---|
datagroup_trigger |
Ansicht | Gibt die Datengruppe, die für die Richtlinie zur Neuerstellung von PDTs verwendet werden soll |
persist_for (für abgeleitete Tabelle) |
Ansicht | Legt das maximale Alter einer PDT fest, bevor diese regeneriert wird. Sie sollten den leistungsstärkeren datagroup_trigger -Parameter verwenden. |
sql_trigger_value |
Ansicht | Gibt die Bedingung an, die dazu führt, dass eine PDT neu erstellt wird Sie sollten den leistungsstärkeren datagroup_trigger -Parameter verwenden. |
Abfrageeffizienz-Parameter für abgeleitete Tabellen
Abhängig vom Datenbankdialekt gibt es einige Parameter, mit denen Sie die Effizienz von abgeleiteten Tabellen erhöhen können.
Parametername | Stufe | Beschreibung |
---|---|---|
cluster_keys |
Ansicht | Gibt an, dass ein PDT oder eine zusammengefasste Tabelle durch ein oder mehrere Felder in BigQuery geclustert wird Unterstützung für cluster_keys in Snowflake hinzugefügt
Unterstützung für cluster_keys mit zusammengefassten Tabellen hinzugefügt |
distribution |
Ansicht | Legt den Verteilungsschlüssel eines PDT oder einer aggregierten Tabelle fest, die in Redshift oder Aster erstellt wird Support für distribution mit aggregierten Tabellen hinzugefügt |
distribution_style |
Ansicht | Legt den Verteilungsstil eines PDT oder einer aggregierten Tabelle fest, die in Redshift erstellt wird Unterstützung für distribution_style mit aggregierten Tabellen hinzugefügt |
increment_key |
Ansicht |
ADDED 21.4
Wandelt die abgeleitete Tabelle in ein inkrementelles PDT um. increment_key gibt das Zeitintervall an, für das aktuelle Daten abgefragt und an die PDT angehängt werden sollen. |
increment_offset |
Ansicht |
ADDED 21.4
Wird in Verbindung mit dem Parameter increment_key für inkrementelle PDTs verwendet. increment_offset gibt die Anzahl der vorherigen Zeiträume (auf Basis des Detaillierungsgrads) an, die für verspätet ankommende Daten neu erstellt werden. |
indexes |
Ansicht | Legt die Indexe einer PDT oder einer aggregierten Tabelle in einer herkömmlichen Datenbank fest (z.B. MySQL, Postgres) oder einen verschränkten Sortierschlüssel in Redshift Support für indexes mit aggregierten Tabellen hinzugefügt |
partition_keys |
Ansicht | Gibt an, dass ein PDT oder eine zusammengefasste Tabelle durch ein oder mehrere Felder in Presto oder ein einzelnes Datum/Uhrzeit-Feld in BigQuery partitioniert wird Unterstützung für partition_keys mit zusammengefasste Tabellen hinzugefügt |
sortkeys |
Ansicht | Legt die Sortierschlüssel eines PDT oder einer aggregierten Tabelle fest, die in Redshift erstellt wird Unterstützung für sortkeys mit aggregierten Tabellen hinzugefügt |
table_compression |
Ansicht | Gibt die Tabellenkomprimierung für eine PDT in Amazon Athena an |
table_format |
Ansicht | Gibt das Tabellenformat für eine PDT in Amazon Athena an |
Aggregierte Tabellen
Wie auf der Dokumentationsseite Zusammengefasste Daten zur Steigerung der Bekanntheit erläutert, können Sie mithilfe von zusammengefassten Tabellen Abfragen auf dem Tab „Entdecken“ optimieren. Aggregierte Tabellen werden in Ihrer Datenbank beibehalten, ähnlich wie nichtflüchtige abgeleitete Tabellen.
Aggregierte Tabellen werden unter einem Explore definiert.
Parametername | Stufe | Beschreibung |
---|---|---|
aggregate_table |
Entdecken | Erstellt eine aggregierte Tabelle für einen Explore. Dieser Parameter hat Unterparameter, die auf der Dokumentationsseite zum Parameter aggregate_table beschrieben sind. |
Zusätzliche Parameter für das Abfrageverhalten
Verschiedene Parameter wirken sich darauf aus, was und wie Sie abfragen. Einige davon wurden entsprechend ihrer Funktionsweise in anderen Abschnitten dieser Seite beschrieben. In diesem Abschnitt werden die verbleibenden LookML-Parameter beschrieben, mit denen Sie das Abfrageverhalten festlegen können.
Abfrageelemente
Mit diesen Parametern werden bestimmte Informationen über die Verbindungen, Dateien und Felder definiert, die für ihre Abfragen verwendet werden.
Parametername | Stufe | Beschreibung |
---|---|---|
access_grant |
Modell | Erstellt eine Zugriffsberechtigung, die den Zugriff auf LookML-Strukturen auf Nutzer mit genehmigten Nutzerattributwerten beschränkt. Dieser Parameter hat die Unterparameter user_attribute und allowed_values . |
connection |
Modell | Ändert die Datenbankverbindung für ein Modell |
fanout_on
|
Felder: D DG M | Aktiviert den Zugriff auf sich wiederholende Felder in Google BigQuery |
from |
Entdecken | Gibt die Ansicht an, auf der eine explorative Datenanalyse basieren soll, und verweist auf die Felder dieser Ansicht anhand ihres Namens |
required_access_grants |
Entdecken | Beschränkt den Zugriff auf einen Explore auf die Benutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
required_access_grants |
Teilnehmen | Beschränkt den Zugriff auf einen Join auf die Benutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
required_access_grants |
Ansicht | Beschränk den Zugriff auf eine Ansicht auf die Benutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
required_access_grants |
Felder: D DG M F P | Beschränkt den Zugriff auf ein Feld auf die Benutzer, deren Benutzerattributwerte mit den Zugriffsrechten übereinstimmen |
required_fields
|
Felder: D M | Legt fest, dass bei Auswahl eines Feldes zusätzliche Felder zu einer Abfrage hinzugefügt werden müssen |
sql_table_name |
Entdecken | Gibt die Datenbanktabelle an, auf der ein Explore basieren soll |
sql_table_name |
Ansicht | Ändert die SQL-Tabelle, auf der eine Ansicht basiert |
view_name |
Entdecken | Gibt die Ansicht an, auf der eine Ansicht basiert, und verweist auf die Felder dieser Ansicht anhand des Namens der Ansicht |
Abfrageprozess
Diese Parameter beeinflussen die Erstellung bzw. Verarbeitung Ihrer Abfragen durch Looker.
Einige dieser Parameter sind erforderlich, damit symmetrische Aggregationen funktionieren. Weitere Informationen zu symmetrischen Aggregaten finden Sie auch in der Hilfe unter Eine einfache Erklärung von symmetrischen Aggregaten oder „Warum in Google Earth sieht mein SQL so aus?“.
Parametername | Stufe | Beschreibung |
---|---|---|
alias
|
Felder: D DG M F P | Legt fest, dass gespeicherte URLs mit alten Feldnamen nach der Umbenennung eines Feldes funktionsfähig bleiben |
cancel_grouping_fields |
Entdecken | Die GROUP BY -Klausel wird abgebrochen, wenn bestimmte Felder in einem Explore ausgewählt werden |
primary_key
|
Felder: D | Deklariert eine Dimension als Primärschlüssel einer Ansicht |
sql_where |
Teilnehmen | Wenn dieser Join in die Abfrage einbezogen wird, werden Bedingungen in die WHERE -Klausel der Abfrage eingefügt, die ein Nutzer für diese Erkundung nicht ändern oder entfernen kann. Nur für BigQuery. Dieser Parameter kann auch als Filterparameter betrachtet werden. |
symmetric_aggregates |
Entdecken | Gibt an, ob für einen Explore die Funktion für symmetrische Summen aktiviert ist Dieser Parameter wird auch für Parameter aufgeführt, die Messwerte beeinflussen. |
Unzulässige Parameter
In Ihrem Modell werden möglicherweise die folgenden Parameter angezeigt. Daher haben wir hier eine Liste der jeweiligen Parameter für Sie zusammengestellt. Wenn Sie jedoch neue Modellierungen hinzufügen, vermeiden Sie diese Parameter.
Parametername | Stufe | Beschreibung |
---|---|---|
access_filter_fields |
Entdecken |
REMOVED 6.0
Ersetzt durch access_filter |
decimals
|
Felder: D M |
REMOVED 5.4
Ersetzt durch value_format
|
distkey |
Ansicht |
ENTFERNT 3.26
Ersetzt durch distribution |
format
|
Felder: D M |
ENTFERNT 3.16
Ersetzt durch value_format |
scoping |
Modell | REMOVED 3,52 Nicht mehr erforderlich |
sql |
Teilnehmen |
VERMEIDEN 3.10
Ersetzt durch eine Kombination aus sql_on , foreign_key , type und/oder sql_table_name , wie auf der Parameterdokumentation sql (für Joins) beschrieben
|
sql_foreign_key |
Teilnehmen |
VERMEIDEN 3.16
Ersetzt durch foreign_key |
template |
Modell | REMOVED 3.30 Nicht mehr erforderlich |
view_label |
Ansicht |
VERMEIDEN 4.4
Ersetzt durch label |
Weitere Tutorials und Ressourcen
Diese Abschnitte enthalten Links zu zusätzlichen Ressourcen, mit denen Sie Ihre LookML-Kenntnisse vertiefen können und in denen Sie Unterstützung bei anderen Entwickleraufgaben in Looker finden.
Grundlegendes zum Entwicklungsprozess
Der Abschnitt Datenmodellierung des Dokumentationsmenüs von Looker soll Ihnen den Einstieg in den Abschnitt „Entwickeln“ von Looker erleichtern.
Diese Seiten sind möglicherweise hilfreich:
- Entwicklungsmodus und Produktionsmodus
- Projektinformationen aufrufen und bearbeiten
- Videoanleitungen für Entwickler
Grundlegendes zu LookML
Der Abschnitt Schritte zum Lernen von LookML im Dokumentationsmenü von Looker bietet eine Einführung in grundlegende LookML-Konzepte und empfiehlt einen Lernpfad zur Kompetenz in LookML.
Diese Seiten sind möglicherweise hilfreich:
LookML-Dashboards erstellen
Alle Dashboard-Dateien in einem Projekt enthalten LookML-Parameter zum Definieren von Dashboards. Die aktuelle Seite enthält nur Parameter für die Datenmodellierung, keine Dashboard-Parameter. Im Abschnitt LookML-Dashboards erstellen und verwalten des Dokumentationsmenüs von Looker können Sie sich mit LookML-Dashboards vertraut machen.
Diese Seiten sind möglicherweise hilfreich:
- LookML-Dashboards erstellen
- Dashboard-Parameter für Parameter, die ein gesamtes Dashboard betreffen
- Dashboard-Elementparameter für Parameter, die sich auf bestimmte Elemente in einem Dashboard auswirken
Optionen für Einbetten, API und Admin
Einbetten
Die folgenden Seiten sind möglicherweise hilfreich, um mehr über das Einbetten von Looks, Explores und Dashboards zu erfahren:
- Öffentliches Einbetten mit
iframe
-Tags - Private Einbettung
- SSO-Einbettung
- Eingebettete JavaScript-Ereignisse
API
Der Abschnitt Looker API im Dokumentationsmenü von Looker bietet Ihnen einen Einstieg in die sichere, „RESTful“-API (Application Programming Interface).
Optionen für Administratoren
Der Abschnitt Erste Schritte mit Administratoroptionen im Dokumentationsmenü von Looker soll Ihnen den Einstieg im Abschnitt „Admin“ von Looker erleichtern.
Schulung zu Looker Connect
Melden Sie sich zu unserer LookML-Lerntour auf Looker Connect an.