Ein LookML-Projekt ist eine Sammlung von LookML-Dateien, die Looker mitteilen, wie eine Verbindung zur Datenbank hergestellt, Ihre Daten abgefragt und das Verhalten der Benutzeroberfläche gesteuert werden soll. Sie können entweder über den Abschnitt Entwickeln in Looker oder über die Benutzeroberfläche auf LookML-Projektdateien zugreifen, wie auf der Dokumentationsseite Auf LookML-Projektdateien zugreifen beschrieben.
Projektdateien werden von Ihren Looker-Entwicklern mithilfe von Ordnern in der IDE organisiert.
Ein LookML-Projekt besteht aus mindestens einer Modelldatei und mindestens einer Ansichtsdatei sowie möglicherweise einigen der anderen auf dieser Seite beschriebenen Dateitypen. Alle Projektdateien haben Erweiterungen. Sie sind jedoch in der IDE-Liste ausgeblendet, wenn Ihr Projekt nicht für Ordner in der IDE aktiviert ist.
Klicken Sie auf die folgenden Links, um weitere Informationen zu den einzelnen Dateitypen zu erhalten, die in einem LookML-Projekt verwendet werden können:
- Modelldateien mit der Erweiterung
.model.lkml - Dateien ansehen mit der Erweiterung „
.view.lkml“ - Dashboard-Dateien mit der Erweiterung
.dashboard.lookml - Datendateien mit der Erweiterung
.topojson,.geojsonoder.json - Dokumentdateien mit der Erweiterung
.md - Projektmanifestdateien, die immer den Namen
manifest.lkmlhaben - Manifest-Sperrdateien mit der Erweiterung
.lkml - Gebietsschema-Stringdateien mit der Erweiterung
.strings.json - Dateien ansehen mit der Erweiterung
.explore.lkml - Datentestdateien mit der Erweiterung
.lkml - Suchfilterdateien mit der Erweiterung
.lkml - Andere Dateien mit einer zuvor nicht aufgeführten Dateiendung
Nachdem Sie ein LookML-Projekt erstellt haben, können Sie mit der Looker IDE auf die Projektdateien zugreifen und dem Projekt neue Dateien und Ordner hinzufügen.
Modelldateien
Eine Modelldatei gibt eine Datenbankverbindung und die Gruppe der Explores an, die diese Verbindung verwenden. In einer Modelldatei werden auch die Explores selbst und ihre Beziehungen zu anderen Ansichten definiert. Ein Explore ist ein Ausgangspunkt zum Abfragen Ihrer Daten. In SQL ist ein Explore die FROM-Klausel einer Abfrage. Die Explores, die Sie im Modell definieren, sind für Ihre Nutzer sichtbar, wenn sie das Looker-Menü Explore aufrufen.
Mit anderen Worten: In der Modelldatei definieren Sie, welche Datentabellen (als eingeschlossene Ansichten) verwendet und bei Bedarf zusammengeführt werden sollen.
Anweisungen zum Erstellen von LookML-Projektdateien, einschließlich Modelldateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Struktur und allgemeine Syntax
Innerhalb der geschweiften Klammern { } eines Explores definieren Sie Parameter für das Explore. Sie können join-Parameter verwenden, um andere Ansichten in einer Modelldatei mit einem Explore zu verknüpfen.
Im folgenden Beispiel definiert der LookML-Code in einer Beispieldatei ein Explore namens inventory_items sowie die zugehörigen verknüpften Ansichten:
connection: "thelook_events"
explore: inventory_items {
join: products {
type: left_outer
sql_on: ${inventory_items.product_id} = ${products.id} ;;
relationship: many_to_one
}
join: distribution_centers {
type: left_outer
sql_on: ${products.distribution_center_id} = ${distribution_center.id} ;;
relationship: many_to_one
}
}
Diese LookML-Definition führt dazu, dass Inventory Items (Inventarelemente) im Abschnitt Explore der Looker-Navigation angezeigt wird. Außerdem werden Daten aus den Ansichten products und distribution_centers mit der Ansicht inventory_items zusammengeführt.
Weitere Informationen zu den LookML-Strukturen einer Modelldatei finden Sie auf der Dokumentationsseite LookML – Begriffe und Konzepte.
Weitere Informationen zu LookML-Parametern in der Modelldatei finden Sie auf den Dokumentationsseiten Modellparameter, Explore-Parameter und Join-Parameter.
Dateien ansehen
Eine Ansichtsdatei definiert in der Regel eine einzelne „Ansicht“ innerhalb von Looker. Eine Ansicht entspricht entweder einer einzelnen Tabelle in Ihrer Datenbank oder einer einzelnen abgeleiteten Tabelle. Die Ansichtsdatei gibt eine Tabelle an, die abgefragt werden soll, und die Felder (Dimensionen und Messwerte), die aus dieser Tabelle enthalten sein sollen, damit Benutzer Abfragen mit diesen Feldern in der Looker-Benutzeroberfläche erstellen können.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Ansichtsdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Struktur und allgemeine Syntax
In den geschweiften Klammern { } jeder Ansicht stehen Felddefinitionen, die in der Regel einer Spalte in der zugrunde liegenden Tabelle oder einer Berechnung in Looker entsprechen. Die meisten davon werden von Looker entweder als Dimensionen oder Messwerte kategorisiert.
Im folgenden Beispiel einer Ansichtsdatei enthält die Datei orders.view Definitionen für die Dimensionen id, status und user_id, die Dimensionsgruppe created und den Messwert count:
view: orders {
sql_table_name: demo_db.orders ;;
drill_fields: [id]
dimension: id {
primary_key: yes
type: number
sql: ${TABLE}.id ;;
}
dimension: status {
type: string
sql: ${TABLE}.status ;;
}
dimension: user_id {
type: number
# hidden: yes
sql: ${TABLE}.user_id ;;
}
dimension_group: created {
type: time
timeframes: [
raw,
time,
date,
week,
month,
quarter,
year
]
sql: ${TABLE}.created_at ;;
}
measure: count {
type: count
drill_fields: [id, users.id, users.first_name, users.last_name, order_items.count]
}
}
Die Definition dieser Felder in der Ansicht orders enthält die Felder Erstellungsdatum, ID, Status, User ID und Anzahl im Field Picker für das Explore Orders (Aufträge).
Nutzer, die Zugriff auf das Explore Orders (Aufträge) haben, können das Explore Orders (Aufträge) abfragen, indem sie diese Felder auswählen und filtern.
Neben Dimensionen und Kennzahlen können Sie auch mehrere zeitbasierte Dimensionen gleichzeitig mithilfe von Dimensionsgruppen erstellen oder mithilfe von Filterfeldern einen Filter für Ihre Nutzer festlegen. Auf der Dokumentationsseite Ansichtsparameter finden Sie weitere Informationen zu LookML-Parametern in Ansichtsdateien. Auf der Dokumentationsseite Feldparameter finden Sie Informationen zu den LookML-Parametern, die zum Definieren von Dimensionen, Messwerten, Dimensionsgruppen und Filterfeldern in LookML verwendet werden.
Dashboarddateien
Looker unterstützt zwei Arten von Dashboards:
- Benutzerdefinierte Dashboards, die von Nicht-Entwicklern ohne LookML erstellt werden können. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen.
- LookML-Dashboards, die als versionsgesteuerte Dateien gespeichert werden, die mit dem Projekt verknüpft sind.
Wenn Ihr Projekt LookML-Dashboards enthält, werden diese in speziellen Dashboard-Dateien in der IDE mit der Erweiterung .dashboard.lookml definiert.
Weitere Informationen zu LookML-Dashboards finden Sie auf der Dokumentationsseite LookML-Dashboards erstellen.
Dokumentdateien
Mithilfe von Looker-Dokumentdateien können Sie mit Markdown in GitHub eine Dokumentation oder andere Hinweise zu Ihrem Looker-Datenmodell verfassen. Dies kann für Ihre Benutzer hilfreich sein, um sich mit der Verwendung von Looker in Ihrem Unternehmen vertraut zu machen.
Anweisungen zum Erstellen von LookML-Projektdateien, einschließlich Dokumentdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dokument außerhalb der IDE ansehen
Um ein Dokument außerhalb der IDE aufzurufen und die auf dieser Seite beschriebenen Navigationsfunktionen zu nutzen, wählen Sie für die Dokumentdatei im Menü Dateiaktionen ansehen die Option Dokument anzeigen aus:
Sie können die URL der resultierenden Seite an andere Benutzer weitergeben, sodass diese nicht über den Entwicklerbereich von Looker navigieren müssen, um sie zu erreichen.
Navigationsstruktur zu einem Dokument hinzufügen
Sie können Ihren Dokumentdateien eine Seitenleiste hinzufügen, damit Nutzende einfach die Struktur der Informationen sehen und zwischen Dokumenten wechseln können.
Wenn Sie einem Dokument eine Seitenleistennavigation hinzufügen möchten, erstellen Sie einen Navigationsabschnitt, der mit der ersten Zeile des Dokuments beginnt. Markieren Sie den Anfang und das Ende des Navigationsabschnitts mit drei Bindestrichen (---).
Sie können im Navigationsbereich die folgenden Parameter verwenden:
navigation
Sie können navigation: true in einer Dokumentdatei verwenden, um diesem Dokument die Navigationsleiste hinzuzufügen. Beispielsweise können Sie den folgenden Code oben in einer Markdown-Datei einfügen:
---
navigation: true
---
Mit diesem Code wird dem Dokument eine Seitenleiste mit Links zu allen Dokumenten des Projekts hinzugefügt. Wenn Sie nur navigation: true in ein Dokument einfügen, werden in der Seitenleiste dieses Dokuments alle Dokumente des Projekts in alphabetischer Reihenfolge nach Dateiname aufgelistet.
Vielleicht stellen Sie auch fest, dass die Sortierung nach alphabetischem Dateinamen nicht ideal ist oder Sie haben einige Dokumente, die nicht in der Navigation angezeigt werden sollen:
In diesem Beispiel sollten Sie die Dokumente Dokument 1, Dokument 2, Dokument 3 und Dokument 4 in numerischer Reihenfolge statt alphabetischer Reihenfolge auflisten und das Dokument in der Navigationsleiste nicht anzeigen lassen.
Um die Reihenfolge der Dokumente in der Navigationsleiste zu ändern oder nur einen Teil Ihrer Dokumente in der Seitenleiste anzuzeigen, können Sie folgendes Format verwenden:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Die Navigation zeigt nun nur die Dokumentdateien an, die angezeigt werden sollen, und sie erscheinen in einer logischeren Reihenfolge:
title
Standardmäßig wird in der Seitenleiste die Überschrift des Dokuments angezeigt (wenn das Dokument mit einer Überschrift beginnt) oder den Dateinamen des Dokuments, wenn die Datei keine Überschrift hat. Sie können oben in einem Dokument den Parameter title hinzufügen, um zu ändern, wie das Dokument in der Navigationsleiste angezeigt wird:
---
title: New Title for Users
---
Dieser Titel wird als Linktext in den Navigationsleisten aller Dokumente verwendet, sofern Sie im Navigationsbereich eines Dokuments kein anderes label angeben.
label
Wenn Sie ändern möchten, wie ein Dokument in der Navigationsleiste aufgelistet wird, können Sie die Parameter document und label so verwenden:
---
navigation:
- document_one
- document: document_two
label: Customized Label for Document Two
- document_three
- document_four
---
Mit dem Wert label wird definiert, wie ein Dokument in der Seitenleiste des Dokuments angezeigt wird, auch wenn das Dokument, auf das es verweist, einen eigenen title-Parameter hat.
Das vorherige Beispiel sieht in der Seitenleiste des Dokuments so aus:
section
Wenn Sie die Navigationsleiste in Abschnitte unterteilen möchten, können Sie den Parameter section so verwenden:
---
navigation:
- document_one
- document_two
- section: My Section Name
- document_three
- document_four
---
In diesem Beispiel fügt der Parameter section einen Abschnittswechsel und die Textüberschrift Mein Bereichsname in die Seitenleiste ein.
Die Textüberschrift selbst ist kein Link; sie verweist nicht auf eine Ihrer Dokumentdateien.
Datendateien
Datendateien sind JSON-Dateien mit der Dateiendung .json, .topojson oder .geojson.
Mit dem Parameter map_layer können Sie eine JSON-Datei als benutzerdefinierte Zuordnung verwenden, mit der Sie Ihre Daten dann in Looker darstellen können.
Anschließend verwenden Sie den Parameter map_layer_name mit einer Dimension, um einen Datenwert wie „Paris“ mit einer geografischen Region auf Ihrer benutzerdefinierten Karte zu verknüpfen.
Sie können eine JSON-Datei in der LookML-IDE bearbeiten und dann auf Speichern klicken.
Für das Debugging können Sie Rohdaten anzeigen auswählen, indem Sie neben dem Namen der Datei das Menü Dateiaktionen ansehen auswählen, um sich die Datei im RAW-Format anzusehen. Wenn Sie die richtige Erweiterung zum Anzeigen von JSON in Ihrem Browser haben, können Sie die Datei auch in einem geparsten Format ansehen.
Eine Anleitung zum Hochladen einer JSON-Datei in ein LookML-Projekt finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Projektmanifestdateien
Ihr Projekt kann eine Projektmanifestdatei enthalten, die für die folgenden Aufgaben verwendet wird:
- Angabe weiterer Projekte für den Import in das aktuelle Projekt
- Einstellungen für die Modelllokalisierung angeben
- LookML-Konstanten definieren
- Erweiterung zu Ihrem Projekt hinzufügen
- Dem Projekt eine benutzerdefinierte Visualisierung hinzufügen
Jedes Projekt kann nur eine Manifestdatei haben. Diese muss den Namen manifest.lkml haben und sich auf der Stammebene der Verzeichnisstruktur Ihres Projekts sowie in Ihrem Git-Repository befinden.
Eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Projektmanifestdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Manifest-Sperrdateien
Manifestsperrdateien werden automatisch erstellt, wenn der Manifestdatei des Projekts eine Remote-Abhängigkeit hinzugefügt wird. Looker verwendet die Manifest-Sperrdatei, um die Version der Remote-Projekte zu verfolgen, die in der Manifestdatei angegeben sind. Die Manifest-Sperrdatei ist im Dateibrowser der Looker IDE aufgeführt und hat den Dateinamen manifest_lock.lkml.
Looker-Entwickler müssen keine Manifest-Sperrdatei erstellen oder bearbeiten, da Sperrdateien automatisch von Looker verwaltet werden.
Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.
Datei mit Sprachstrings
Wenn Sie Ihr Datenmodell lokalisieren, müssen Sie für jedes Gebietsschema, das lokalisiert werden soll, Gebietsschema-Zeichenfolgendateien erstellen, einschließlich Ihrer Standardsprache (z. B. Englisch in den USA).
Sprachstringdateien enthalten Schlüssel/Wert-Paare für jedes Label und jede Beschreibung, die Sie in Ihrem Modell lokalisieren. Die Zeichenfolgendatei für jedes Gebietsschema sollte die Übersetzung der betreffenden Sprache für jedes Label oder jede Beschreibung enthalten. Weitere Informationen zum Erstellen von Gebietsschema-Stringdateien finden Sie auf der Dokumentationsseite Ihr LookML-Modell lokalisieren.
Anweisungen zum Erstellen von LookML-Projektdateien, einschließlich Gebietsschema-Zeichenfolgendateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dateien ansehen
Ein Explore ist eine Ansicht, die Nutzer abfragen können. Ein Explore ist der Ausgangspunkt für eine Abfrage oder, in SQL ausgedrückt, die FROM in einer SQL-Anweisung. Informationen dazu, wie Nutzer mit Explores Ihre Daten abfragen, finden Sie auf der Dokumentationsseite Explores in Looker ansehen und mit ihnen interagieren.
Explores werden normalerweise in einer Modelldatei definiert. Manchmal benötigen Sie jedoch eine separate Explore-Datei für eine abgeleitete Tabelle oder um ein Explore modellübergreifend zu erweitern oder zu verfeinern.
Anweisungen zum Erstellen von LookML-Projektdateien, einschließlich Explore-Dateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Datentestdateien
Ihr Projekt enthält möglicherweise Datentestdateien, mit denen die Logik des LookML-Modells verifiziert wird. Datentests können in Modell- oder Ansichtsdateien enthalten sein. Wenn Ihre Entwickler jedoch dieselben Datentests für mehrere verschiedene Modelle verwenden möchten, kann es hilfreich sein, die Datentests in einer eigenen, dedizierten Datei zu belassen.
Anweisungen zum Erstellen von LookML-Projektdateien, einschließlich Datentestdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dateien für Suchfilter
Möglicherweise enthält Ihr Projekt Dateien, die für LookML-Verfeinerungen verwendet werden. Mit LookML-Verfeinerungen können Sie eine vorhandene Ansicht oder Explore anpassen, ohne die LookML-Datei, die sie enthält, zu bearbeiten. LookML-Verfeinerungen können in Modell-, Ansichts- oder Explore-Dateien oder in ihrer eigenen, dedizierten Datei enthalten sein.
Eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Verfeinerungsdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Sonstige Dateien
Viele LookML-Elemente können in verschiedenen Dateien in Ihrem Projekt oder in eigenen, dedizierten Dateien verwaltet werden. Datentests können beispielsweise in Modell-, Ansichtsdateien oder in eigenen .lkml-Dateien gespeichert werden.