Ein LookML-Projekt ist eine Sammlung von LookML-Dateien. Sie teilen Looker mit, wie eine Verbindung zu Ihrer Datenbank hergestellt, wie Ihre Daten abgefragt und das Verhalten der Benutzeroberfläche gesteuert werden soll. Sie können entweder über den Abschnitt Develop 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 und möglicherweise auch einigen der anderen, auf dieser Seite beschriebenen Dateitypen. Alle Projektdateien haben Erweiterungen. Diese sind jedoch in der IDE-Liste versteckt, 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 Endung
.model.lkml - Dateien mit der Erweiterung
.view.lkmlansehen - Dashboard-Dateien mit der Erweiterung
.dashboard.lookml - Datendateien mit der Endung
.topojsonoder.geojsonoder.json - Dokumentdateien mit der Erweiterung
.md - Projektmanifestdateien, die immer den Namen
manifest.lkmlhaben - Manifest-Sperrdateien mit der Erweiterung
.lkml - Sprache-String-Dateien mit der Endung
.strings.json - Dateien mit der Erweiterung
.explore.lkmlansehen - Datentestdateien mit der Endung
.lkml - Dateien zur Verfeinerung mit der Erweiterung
.lkml - Andere Dateien mit einer Dateiendung, die zuvor nicht aufgeführt sind
Nachdem Sie ein LookML-Projekt erstellt haben, können Sie über die Looker-IDE auf die Projektdateien zugreifen und dem Projekt neue Dateien und Ordner hinzufügen.
Modelldateien
In einer Modelldatei werden eine Datenbankverbindung und die Gruppe von Explores angegeben, die diese Verbindung verwenden. In einer Modelldatei werden auch die Explores selbst und ihre Beziehungen zu anderen Ansichten definiert. Ein Explore ist ein Ausgangspunkt für die Abfrage 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 verwendet werden (als enthaltene Ansichten) und wie sie bei Bedarf verknüpft werden sollen.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Modelldateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Struktur und allgemeine Syntax
In den geschweiften Klammern eines Explores ({ }) definieren Sie Parameter für das Explore. Sie können join-Parameter verwenden, um andere Ansichten mit einem Explore in einer Modelldatei zu verbinden.
Im folgenden Beispiel definiert die LookML in einer Beispielmodelldatei ein Explore namens inventory_items zusammen mit seinen 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
}
}
Durch diese LookML-Definition werden Inventarelemente im Bereich Erkunden der Looker-Navigation angezeigt und Daten aus den Ansichten products und distribution_centers werden mit der Ansicht inventory_items zusammengeführt.
Weitere Informationen zu den LookML-Strukturen in 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 im Allgemeinen eine einzelne „Ansicht“ in 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, sowie die Felder (Dimensionen und Kennzahlen), die aus dieser Tabelle einbezogen werden sollen, damit Nutzer 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 der einzelnen Ansichten ({ }) befinden sich Felddefinitionen, die in der Regel einer Spalte in der zugrunde liegenden Tabelle oder einer Berechnung in Looker entsprechen. In Looker werden die meisten davon entweder als Dimensionen oder als 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]
}
}
Durch die Definition dieser Felder in der Ansicht orders sind die Felder Erstellungsdatum, ID, Status, User ID und Anzahl im Field Picker für das Explore Orders verfügbar.
Nutzer mit Zugriff auf das Explore Aufträge können das Explore Aufträge abfragen, indem sie diese Felder auswählen und filtern.
Zusätzlich zu Dimensionen und Messwerten können Sie mithilfe von Dimensionsgruppen auch mehrere zeitbasierte Dimensionen gleichzeitig erstellen oder mit Filterfeldern einen Filter für Ihre Nutzer festlegen. Weitere Informationen zu LookML-Parametern in Ansichtsdateien finden Sie auf der Dokumentationsseite Parameter anzeigen. Auf der Dokumentationsseite Feldparameter finden Sie Informationen zu den LookML-Parametern, mit denen Dimensionen, Messwerte, Dimensionsgruppen und Filterfelder in LookML definiert 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 Dashboarddateien 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 eine Dokumentation oder andere Hinweise zu Ihrem Looker-Datenmodell über das GitHub-basierte Markdown erstellen. Dies kann für Ihre Nutzer hilfreich sein, um sich mit der Verwendung von Looker in Ihrem Unternehmen vertraut zu machen.
Eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Dokumentdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dokument außerhalb der IDE ansehen
Wenn Sie ein Dokument außerhalb der IDE anzeigen möchten, wählen Sie im Menü Dateiaktionen anzeigen für die Dokumentdatei die Option Dokument anzeigen aus. Damit können Sie die auf dieser Seite beschriebenen Navigationsfunktionen nutzen:
Sie können die URL der resultierenden Seite an andere Benutzer verteilen, damit diese nicht den Entwicklerbereich von Looker durchgehen müssen, um sie zu erreichen.
Navigationsstruktur in ein Dokument einfügen
Sie können Ihren Dokumentdateien eine Seitenleiste hinzufügen, damit Nutzer die Struktur der Informationen leicht sehen und zwischen Dokumenten navigieren können.
Wenn Sie eine Seitenleistennavigation für ein Dokument hinzufügen möchten, erstellen Sie einen Navigationsabschnitt, der in der ersten Zeile des Dokuments beginnt. Markieren Sie den Anfang und das Ende Ihres Navigationsbereichs mit drei Bindestrichen (---).
Sie können die folgenden Parameter im Navigationsbereich verwenden:
navigation
Sie können navigation: true in einer Dokumentdatei verwenden, um diesem Dokument die Navigationsleiste hinzuzufügen. Sie können beispielsweise den folgenden Code oben in eine 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 alle Dokumente des Projekts in alphabetischer Reihenfolge nach Dateiname aufgelistet.
Vielleicht stellen Sie auch fest, dass das Sortieren nach alphabetischen Dateinamen nicht ideal ist, oder es gibt einige Dokumente, die nicht in der Navigation angezeigt werden sollen:
In diesem Beispiel möchten Sie die Dokumente Dokument 1, Dokument 2, Dokument 3 und Dokument 4 in numerischer Reihenfolge anstatt in alphabetischer Reihenfolge auflisten und das Dokument Nicht anzeigen in der Navigationsleiste ausblenden.
Wenn Sie die Reihenfolge der Dokumente in der Navigationsleiste ändern oder nur einen Teil Ihrer Dokumente in der Seitenleiste anzeigen möchten, können Sie folgendes Format verwenden:
---
navigation:
- document_one
- document_two
- document_three
- document_four
---
Jetzt werden in der Navigation nur die Dokumentdateien angezeigt, die angezeigt werden sollen, und diese werden in einer logischeren Reihenfolge angezeigt:
title
Standardmäßig zeigt die Seitenleiste die Überschrift des Dokuments an (wenn das Dokument mit einer Überschrift beginnt) oder den Dateinamen des Dokuments, wenn es keine Überschrift in der Datei gibt. Sie können oben in einem Dokument den Parameter title hinzufügen, um zu ändern, wie das Dokument in den Navigationsleisten 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 aufgeführt 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
---
Der Wert label definiert, wie ein Dokument in der Seitenleiste des Dokuments angezeigt wird, auch wenn das Dokument, auf das er verweist, einen eigenen title-Parameter hat.
Das vorherige Beispiel in der Seitenleiste des Dokuments sieht 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 der Seitenleiste einen Abschnittswechsel und die Textüberschrift Mein Abschnittsname hinzu.
Die Textüberschrift ist kein Link selbst; sie verweist auf keine 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, die dann für die grafische Darstellung Ihrer Daten in Looker verwendet werden kann.
Anschließend verwenden Sie den Parameter map_layer_name mit einer Dimension, damit Sie einen Datenwert (z. B. "Paris") mit einer geografischen Region auf Ihrer benutzerdefinierten Karte verknüpfen können.
Sie können eine JSON-Datei in der LookML-IDE bearbeiten und dann Speichern auswählen.
Zur Fehlerbehebung können Sie Rohdaten ansehen auswählen, indem Sie das Menü Dateiaktionen anzeigen neben dem Dateinamen auswählen, um die Datei im Rohformat anzusehen. Wenn Sie die richtige Erweiterung für die Anzeige von JSON in Ihrem Browser haben, haben Sie auch die Möglichkeit, die Datei im geparsten Format anzusehen.
Eine Anleitung zum Hochladen einer JSON-Datei in ein LookML-Projekt finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Projektmanifestdateien
Ihr Projekt enthält möglicherweise eine Projektmanifestdatei, die für die folgenden Aufgaben verwendet wird:
- Andere Projekte für den Import in das aktuelle Projekt angeben
- Einstellungen für die Modelllokalisierung festlegen
- 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.
Manifestsperrdateien
Manifestsperrdateien werden automatisch erstellt, wenn der Projektmanifestdatei eine Remote-Abhängigkeit hinzugefügt wird. Looker verwendet die Manifestsperre, um die Version der Remote-Projekte zu verfolgen, die in der Manifestdatei angegeben sind. Die Manifestsperre ist im Dateibrowser der Looker-IDE aufgeführt und hat den Dateinamen manifest_lock.lkml.
Looker-Entwickler müssen keine Manifestsperrdatei erstellen oder bearbeiten, da Sperrdateien automatisch von Looker verwaltet werden.
Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.
Sprachstringdateien
Wenn Sie Ihr Datenmodell lokalisieren, müssen Sie für jedes Gebietsschema, das Sie lokalisieren möchten, Sprachstringdateien erstellen, einschließlich Ihrer Standardsprache (zum Beispiel häufig Englisch in den USA).
In Sprachstringdateien werden Schlüssel/Wert-Paare für jedes Label und jede Beschreibung aufgelistet, die Sie in Ihrem Modell lokalisieren. Die Zeichenfolgendatei für jedes Gebietsschema sollte die Übersetzung dieser Sprache für jedes Label oder jede Beschreibung enthalten. Weitere Informationen zum Erstellen von Sprachstringdateien finden Sie auf der Dokumentationsseite Ihr LookML-Modell lokalisieren.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Gebietsschema-Stringdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dateien untersuchen
Ein Explore ist eine Ansicht, die Nutzer abfragen können. Ein Explore ist der Ausgangspunkt für eine Abfrage oder in SQL-Begriffen die FROM in einer SQL-Anweisung. Informationen dazu, wie Nutzer zum Abfragen Ihrer Daten mit Explores interagieren, 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.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Explore-Dateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Datentestdateien
Ihr Projekt verfügt möglicherweise über Datentestdateien, die zum Verifizieren der Logik Ihres LookML-Modells verwendet werden. Datentests können in Modelldateien oder in 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 speichern.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Datentestdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.
Dateien für Suchfilter
Ihr Projekt enthält möglicherweise Dateien, die für LookML-Verfeinerungen verwendet wurden. Mit LookML-Verfeinerungen können Sie eine vorhandene Ansicht oder Explore anpassen, ohne die darin enthaltene LookML-Datei zu bearbeiten. LookML-Verfeinerungen können in Modell-, Ansichts- oder Explore-Dateien oder in einer eigenen dedizierten Datei enthalten sein.
Anleitungen zum Erstellen von LookML-Projektdateien, einschließlich Dateien für Verfeinerungen, 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 ihren eigenen dedizierten Dateien gespeichert werden. Datentests können beispielsweise in Modelldateien, Ansichtsdateien oder ihren eigenen dedizierten .lkml-Dateien gespeichert werden.