Diese Seite bietet einen Überblick über Modell- und Ansichtsdateien, die wichtige Komponenten der meisten Looker-Projekte sind. Die anderen Arten von Projektdateien werden auf der Dokumentationsseite Informationen zu anderen Projektdateien beschrieben. Informationen zum Zugriff auf die Projektdateien finden Sie auf der Dokumentationsseite Projektinformationen aufrufen und bearbeiten.
Modelldateien
Eine Modelldatei gibt eine Datenbankverbindung sowie die Gruppe von „Entdecken“ an, die diese Verbindung verwenden. In einer Modelldatei werden auch die Erkundungen selbst und ihre Beziehungen zu anderen Ansichten definiert.
Auf dem Tab „Entdecken“ können Sie Ihre Daten abfragen. In SQL ist eine explorative Datenanalyse die FROM
-Klausel einer Abfrage. Die im Modell definierten Entdeckungen sind für Ihre Nutzer sichtbar, wenn sie das Menü „Erkunden“ von Looker aufrufen. Weitere Informationen zu Explores finden Sie auf der Dokumentationsseite So funktioniert ein Projekt in Looker.
Mit anderen Worten: In der Modelldatei definieren Sie, welche Datentabellen verwendet werden sollen (einschließlich Ansichten) und wie sie bei Bedarf miteinander verknüpft werden.
Erkundungen werden normalerweise in einer Modelldatei definiert. Manchmal benötigen Sie jedoch eine separate Explore-Datei für eine abgeleitete Tabelle oder eine geräteübergreifende Erweiterung oder Optimierung für Modelle.
Struktur und allgemeine Syntax
In den geschweiften Klammern „Entdecken“ { }
definieren Sie Parameter für das Attribut „Erkunden“. Sie können join
-Parameter verwenden, um in einer Modelldatei weitere Datenansichten mit einer Funktion zum Erkunden zu verknüpfen.
Oben sehen Sie den explore
mit dem Namen inventory_items
in der Modelldatei sowie die zugehörigen verknüpften Ansichten. Diese LookML-Definition führt dazu, dass Inventarelemente im Menü Erkunden angezeigt werden. Dabei werden die Daten von inventory_items
mit products
und distribution_centers
zusammengeführt.
Weitere Informationen zu den LookML-Strukturen in einer Modelldatei finden Sie auf der Dokumentationsseite LookML-Begriffe und -Konzepte.
Modelldateien erstellen
Die meisten LookML-Entwickler beginnen mit einer oder mehreren Modelldateien, die automatisch erstellt werden, wenn das LookML-Projekt aus einer Reihe von Tabellen in einer Datenbank generiert wird.
Alternativ kann ein Looker-Entwickler im Entwicklungsmodus auf folgende Weise eine leere Modelldatei erstellen:
- Verwenden Sie die Option Modelldatei erstellen, um die Datei mit der Looker-IDE zu erstellen. Weitere Informationen finden Sie im Abschnitt Dateien erstellen auf der Dokumentationsseite Mit Ordnern in der IDE arbeiten.
- Sie laden die Datei per Drag-and-drop von Ihrem Computer hoch. Eine Anleitung hierzu finden Sie im Abschnitt Dateien hochladen auf der Dokumentationsseite Mit Ordnern in der IDE arbeiten. Achten Sie darauf, die Dateierweiterung „
.model.lkml
“ für die hochzuladende Datei zu verwenden.
Sie können jede Modelldatei ändern, indem Sie „Erkunden“ hinzufügen oder entfernen, Joins angeben und weitere Funktionen hinzufügen.
Wenn Sie ein Modell oder ein Objekt im Modell umbenennen müssen, benennen Sie die Datei oder das Objekt selbst nicht um. Verwenden Sie stattdessen den Parameter
label
oderalias
, um den angezeigten Namen der Datei oder des Objekts zu ändern. Die Parameterlabel
undalias
ändern den angezeigten Namen und behalten die zugrunde liegende URL, die für E-Mails oder andere Systeme verwendet wird.Im Allgemeinen sollten Sie Vorkehrungen treffen, um Änderungen am Modell so unaufdringlich wie möglich vorzunehmen. Wenn Sie ein Modell oder Objekt umbenennen müssen, aktualisieren Sie mit dem Inhaltsvalidator alle Verweise auf das Modell oder Objekt.
Wenn Sie eine Modelldatei löschen, wird das Modell nicht aus allen Modellsätzen entfernt, zu denen das Modell gehört. Wenn eine neue Modelldatei mit demselben Namen wie ein gelöschtes Modell erstellt wird, ist das neue Modell in allen Modellsätzen enthalten, die das gelöschte Modell enthalten. Dies kann zu unerwünschtem Zugriff auf die neue Modelldatei führen. Looker-Administratoren können Modellsätze bearbeiten und ein gelöschtes Modell entfernen, um dieses Problem zu vermeiden.
Weitere Informationen zu Parametern in Modelldateien
Weitere Informationen zu LookML-Parametern in der Modelldatei finden Sie auf den Dokumentationsseiten Modellparameter, Parameter entdecken und Join-Parameter.
Dateien ansehen
Eine Ansichtsdatei definiert in der Regel eine einzelne Ansicht in Looker. Eine Ansicht entspricht entweder einer einzelnen Tabelle in Ihrer Datenbank oder einer einzelnen abgeleiteten Tabelle.
Die Ansichtsdatei enthält eine Tabelle, die abgefragt werden soll, sowie die Felder (Dimensionen und Messwerte), die aus dieser Tabelle enthalten sein sollen.
Struktur und allgemeine Syntax
Geschweifte Klammern in jeder Ansicht sind { }
-Felddefinitionen, die in der Regel einer Spalte in der zugrunde liegenden Tabelle oder einer Berechnung in Looker entsprechen. Die meisten werden als Dimensionen oder Messwerte kategorisiert.
Oben ist die Dimension id
als Feld in der Ansicht Bestellelemente definiert. Bei dieser Definition wird das Feld ID für Abfragen im explorativen Analysetool Bestellelemente angezeigt.
Mithilfe von Dimensionsgruppen lassen sich auch mehrere befristete Dimensionen gleichzeitig erstellen oder Sie können mit Filterfeldern einen Filter für Ihre Nutzer festlegen. Auf der Seite Parameter ansehen finden Sie weitere Informationen zu LookML-Parametern in Ansichtsdateien.
Weitere Informationen zu den LookML-Strukturen in einer Ansichtsdatei finden Sie auf der Dokumentationsseite zu LookML-Begriffen und -Konzepten.
Dimensionen
Die Felder in Looker sind in Dimensionen und Maßeinheiten unterteilt. Für eine Dimension gibt es zwei Möglichkeiten:
- Eine Spalte in der zugrunde liegenden Tabelle
dimension: first_name {
sql: ${TABLE}.first_name ;;
}
- Ein berechneter Wert, der auf anderen Feldern basiert
dimension: full_name {
sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}
In Looker werden Dimensionen immer in der GROUP BY
-Klausel des von Looker generierten SQL-Codes angezeigt.
In LookML können Sie verschiedene Dimensionstypen definieren, die verschiedenen Datentypen oder Formatierungen entsprechen.
Messwerte
Ein Messwert berechnet die Werte aus mehreren Zeilen. Dies entspricht SQL-Aggregatfunktionen wie COUNT()
, SUM()
, AVG()
, MIN()
und MAX()
. Mit Messwerten lassen sich auch einfache Transformationen für andere Maßnahmen ausführen. Weitere Informationen finden Sie in der Dokumentation zu Messtypen.
Oben sehen Sie die in der products
-Datenansichtsdatei definierten Dimensionen und Messwerte.
Ansichtsdateien erstellen
Die meisten LookML-Entwickler beginnen mit einer oder mehreren Ansichtsdateien, die automatisch erstellt werden, wenn das LookML-Projekt aus einer Reihe von Tabellen in einer Datenbank generiert wird. Es gibt jedoch viele Möglichkeiten, wie ein Looker-Entwickler im Entwicklungsmodus einem LookML-Projekt Ansichtsdateien hinzufügen kann:
So erstellen Sie Ansichtsdateien basierend auf Tabellen in einer Datenbank:
- Generieren von Ansichtsdateien aus Datenbanktabellen, wenn Sie zum ersten Mal eine Verbindung zu Ihrer Datenbank herstellen, wie auf der Dokumentationsseite Modell generieren beschrieben
- Generieren von Ansichtsdateien aus Datenbanktabellen für ein Projekt, das bereits mit einer Datenbank verbunden ist, wie im Abschnitt Neue Ansicht aus einer vorhandenen Datenbanktabelle hinzufügen weiter unten auf dieser Seite beschrieben.
Leere Ansichtsdateien erstellen:
- Mit der Option Datei erstellen in der Looker-IDE, wie im Abschnitt Dateien erstellen auf der Dokumentationsseite Mit Ordnern in der IDE arbeiten beschrieben
- Verwenden der Drag-and-drop-Funktion, um die Datei von Ihrem Computer hochzuladen, wie im Abschnitt Dateien hochladen auf der Dokumentationsseite Mit Ordnern in der IDE arbeiten beschrieben. Achten Sie darauf, die Dateierweiterung „
.view.lkml
“ für die hochzuladende Datei zu verwenden.
So erstellen Sie eine Datei für eine abgeleitete Tabelle:
- Beginnen Sie mit einer leeren Ansichtsdatei mithilfe einer der oben genannten Optionen. Definieren Sie dann die abgeleitete Tabelle manuell, wie im Abschnitt Native abgeleitete Tabelle in LookML definieren auf der Dokumentationsseite Native abgeleitete Tabellen erstellen beschrieben.
- Mit Looker die abgeleitete Tabelle „LookML“ aus einem explorativen Analysetool erstellen, wie auf der Dokumentationsseite Native abgeleitete Tabellen erstellen im Abschnitt Mit dem nativen explorativen Analysetool beginnen beschrieben.
- Looker erstellt die abgeleitete Tabelle LookML aus einer SQL Runner-Abfrage, wie auf der Dokumentationsseite Mit SQL Runner abgeleitete Tabellen erstellen beschrieben.
Wenn Sie eine neue Ansicht verwenden möchten, fügen Sie sie mithilfe des Parameters explore
in die Modelldatei ein oder verwenden Sie den Parameter join
, um sie mit einer vorhandenen explorativen Datenanalyse in der Modelldatei zu verknüpfen.
Neue Ansicht aus einer vorhandenen Datenbanktabelle hinzufügen
Im Entwicklungsmodus können Sie eine Ansichtsdatei aus einer vorhandenen Datenbanktabelle erstellen.
Klicken Sie in einem Projekt oben in der Projektdateiliste von Looker IDE auf +. Sie können auch auf das Menü eines Ordners klicken, um die Datei im Ordner zu erstellen.
Klicken Sie auf Ansicht aus Tabelle erstellen.
Looker zeigt eine Liste der Tabellen an, die einer Ihrer Verbindungen zugeordnet sind. Über das Drop-down-Menü Verbindung oben links können Sie die Verbindung ändern.
Wählen Sie die Tabellen aus, aus denen Sie Ansichten erstellen möchten, indem Sie das Kästchen links neben dem Tabellennamen anklicken. Sie können Datenbanken oder Schemas in dieser Liste minimieren und maximieren, um auf alle verfügbaren Tabellen zuzugreifen.
Scrollen Sie zum Ende der Seite und klicken Sie auf Ansichten erstellen.
Looker generiert Ansichten mit LookML für alle Tabellenspalten.
Weitere Informationen zu Parametern in Ansichtsdateien
Weitere Informationen zu Anzeigeparametern finden Sie auf der Dokumentationsseite Parameter ansehen.
Weitere Informationen zu LookML-Parametern für Dimensionen, Maßeinheiten, Dimensionsgruppen und Filterfelder finden Sie auf der Dokumentationsseite Feldparameter.