Dateitypen in einem LookML-Projekt

Ein LookML-Projekt ist eine Sammlung von LookML-Dateien, die Looker angeben, wie eine Verbindung zu Ihrer Datenbank hergestellt, wie Daten abgefragt und wie das Verhalten der Benutzeroberfläche gesteuert werden soll. Sie können auf LookML-Projektdateien entweder über den Bereich Entwickeln in Looker oder über die Benutzeroberfläche 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. Diese werden in der IDE-Liste jedoch ausgeblendet, wenn für Ihr Projekt keine Ordner in der IDE aktiviert sind.

Über die folgenden Links erhalten Sie weitere Informationen zu den einzelnen Dateitypen, die in einem LookML-Projekt verwendet werden können:

• Modelldateien mit der Endung .model.lkml
• Dateien mit der Erweiterung .view.lkml ansehen
• Dashboarddateien mit der Erweiterung .dashboard.lookml
• Dateien mit der Endung .topojson, .geojson oder .json
• Dokumentdateien mit der Erweiterung .md
• Projektmanifestdateien, die immer den Namen manifest.lkml haben
• Manifest-Sperrbalkendateien mit der Erweiterung .lkml
• Dateien mit Sprachstrings mit der Erweiterung .strings.json
• Dateien mit der Erweiterung .explore.lkml untersuchen
• Datentestdateien mit der Erweiterung .lkml
• Optimierungsdateien mit der Erweiterung .lkml
• Sonstige Dateien mit einer zuvor nicht aufgeführten Dateiendung

Hinweis: Wenn Sie kein fortgeschrittener LookML-Entwickler sind, empfehlen wir Ihnen, sich zuerst an die Standard-LookML-Dateitypen zu halten. Einige LookML-Elemente müssen in bestimmten Dateitypen gespeichert werden, z. B. LookML-Parameter im Projektmanifest, die sich in der manifest.lkml-Datei eines Projekts befinden müssen, und der Parameter connection, der in einer .model.lkml-Datei gespeichert werden muss. LookML ist jedoch sehr flexibel und viele LookML-Elemente können in jeder .lkml-Datei gespeichert werden. Fortgeschrittene LookML-Entwickler können mit LookML-Dateien kreativ werden und mit dem Parameter include auf Elemente aus einer LookML-Datei in einer anderen LookML-Datei verweisen. So können sie beispielsweise Verfeinerungen verwenden, um Analyseebenen hinzuzufügen oder eigene Dateien für Datentests erstellen.

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 Explores angegeben, die diese Verbindung verwenden. In einer Modelldatei werden auch die Explores selbst und ihre Beziehungen zu anderen Ansichten definiert. Ein Explore ist der Ausgangspunkt für Abfragen Ihrer Daten. In SQL-Begriffen ist ein Explore die FROM-Klausel einer Abfrage. Die im Modell definierten Explores werden Nutzern im Looker-Menü Explore angezeigt.

Mit anderen Worten: In der Modelldatei legen Sie fest, welche Datentabellen verwendet werden sollen (als enthaltene Ansichten) und wie sie gegebenenfalls zusammengeführt werden sollen.

Hinweis :Explores werden in der Regel in einer Modelldatei definiert. Manchmal benötigen Sie jedoch eine separate Explore-Datei für eine abgeleitete Tabelle oder um ein Explore zu erweitern oder zu verfeinern, das mehrere Modelle umfasst.

Eine Anleitung 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 die Parameter für das Explore. Mit join-Parametern können Sie andere Ansichten mit einem Explore in einer Modelldatei verknüpfen.

Im folgenden Beispiel wird in der LookML einer Beispielmodelldatei ein Explore namens inventory_items zusammen mit den zugehörigen zusammengeführten Ansichten definiert:

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 Expl. Datenanalyse 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 in der Regel eine einzelne „Ansicht“ in Looker. Eine Ansicht entspricht entweder einer einzelnen Tabelle in Ihrer Datenbank oder einer einzelnen abgeleiteten Tabelle. In der Ansichtsdatei wird eine abzufragende Tabelle und die aus dieser Tabelle einzubeziehenden Felder (Dimensionen und Messwerte) angegeben, damit Nutzer in der Looker-Benutzeroberfläche Abfragen mit diesen Feldern erstellen können.

Auf der Seite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Ansichtsdateien.

Struktur und allgemeine Syntax

Innerhalb der geschweiften Klammern { } jeder Ansicht 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 dieser Definitionen 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 die Kennzahl 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 orders-Ansicht werden die Felder Erstellungsdatum, ID, Status, User-ID und Anzahl in der Feldauswahl für die explorative Datenanalyse Bestellungen angezeigt.

Nutzer, die Zugriff auf die explorative Datenanalyse Bestellungen haben, können diese abfragen, indem sie diese Felder auswählen und danach filtern.

Zusätzlich zu Dimensionen und Messwerten können Sie mithilfe von Dimensionsgruppen auch mehrere zeitbezogene Dimensionen gleichzeitig erstellen oder mit Filterfeldern einen Filter für Ihre Nutzer angeben. Weitere Informationen zu LookML-Parametern in Ansichtsdateien finden Sie auf der Seite Ansichtsparameter. Auf der Seite 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 Nutzern ohne Entwicklerkenntnisse ohne Verwendung von LookML erstellt werden können. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen.
• LookML-Dashboards, die als versionierte Dateien gespeichert und 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

Mit Looker-Dokumentdateien können Sie Dokumentationen oder andere Notizen zu Ihrem Looker-Datenmodell in GitHub-konformen Markdown-Dokumenten verfassen. So können sich Ihre Nutzer mit der Verwendung von Looker in Ihrer Organisation vertraut machen.

Auf der Seite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Dokumentdateien.

Dokument außerhalb der IDE ansehen

Wenn Sie ein Dokument außerhalb der IDE aufrufen möchten, um die auf dieser Seite beschriebenen Navigationsfunktionen zu nutzen, wählen Sie für die Dokumentdatei die Option Dokument ansehen aus dem Menü Dateiaktionen ansehen aus:

Sie können die URL der resultierenden Seite an andere Nutzer weitergeben, damit diese direkt auf das Dokument zugreifen können, ohne das Looker-Menü Entwickeln aufrufen zu müssen.

Navigationsstruktur in ein Dokument einfügen

Sie können Ihren Dokumentdateien eine Seitenleiste hinzufügen, damit Nutzer die Struktur der Informationen sehen und zwischen Dokumenten wechseln können.

Wenn Sie einem Dokument eine Seitenleiste hinzufügen möchten, erstellen Sie einen Navigationsbereich, der in der ersten Zeile des Dokuments beginnt. Markieren Sie den Anfang und das Ende des Navigationsbereichs mit drei Bindestriche (---).

Im Navigationsbereich können Sie die folgenden Parameter verwenden:

• navigation
• title
• section
• label

navigation

Sie können navigation: true in einer Dokumentdatei verwenden, um dem 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 Navigationsleiste 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 Dateinamen aufgelistet.

Möglicherweise ist die alphabetische Sortierung der Dateinamen nicht ideal oder Sie haben 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 anstelle der alphabetischen Reihenfolge auflisten und das Dokument Nicht anzeigen aus der Navigationsleiste ausblenden.

Wenn Sie die Reihenfolge der Dokumente in der Navigationsleiste ändern oder nur einen Teil Ihrer Dokumente in der Seitenleiste anzeigen lassen möchten, können Sie dieses Format verwenden:

---
navigation:
  - document_one
  - document_two
  - document_three
  - document_four
---

Jetzt werden in der Navigation nur die Dokumentdateien angezeigt, die Sie sehen möchten. Außerdem werden sie in einer logischeren Reihenfolge angezeigt:

title

Standardmäßig wird in der Seitenleiste die Überschrift des Dokuments angezeigt (falls das Dokument mit einer Überschrift beginnt) oder der Dateiname des Dokuments, wenn die Datei keine Überschrift enthält. Sie können oben in einem Dokument einen title-Parameter hinzufügen, um die Darstellung des Dokuments in Navigationsseitenleisten zu ändern:

---
title: New Title for Users
---

Dieser Titel wird als Linktext in den Navigationsleisten aller Dokumente verwendet, sofern Sie im Navigationsbereich eines Dokuments keinen anderen 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
---

Hinweis :Wenn Sie den Parameter label verwenden möchten, müssen Sie document: vor dem Dateinamen des Dokuments einfügen, wie im vorherigen Beispiel gezeigt. Wenn Sie für ein Dokument kein label verwenden, fügen Sie document: nicht vor dem Dateinamen ein.

Der Wert label gibt an, wie ein Dokument in der Seitenleiste angezeigt wird, auch wenn das Dokument, auf das es sich bezieht, 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 wird mit dem Parameter section ein Abschnittswechsel und die Textüberschrift My Section Name (Mein Abschnittsname) in die Seitenleiste eingefügt.

Die Textüberschrift ist kein Link und 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 Karte verwenden, um Ihre Daten in Looker zu visualisieren.

Verwenden Sie dann den Parameter map_layer_name mit einer Dimension, um einen Datenwert (z. B. „Paris“) einer geografischen Region auf Ihrer benutzerdefinierten Karte zuzuordnen.

Sie können eine JSON-Datei in der LookML-IDE bearbeiten und dann Speichern auswählen.

Für die Fehlerbehebung können Sie Im Rohformat ansehen auswählen, indem Sie das Menü Dateiaktionen ansehen neben dem Namen der Datei öffnen. Wenn Sie die richtige Erweiterung zum Anzeigen von JSON in Ihrem Browser haben, können Sie die Datei auch im 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:

• Andere Projekte angeben, die in das aktuelle Projekt importiert werden sollen
• Einstellungen für die Modelllokalisierung angeben
• LookML-Konstanten definieren
• Ihrem Projekt eine Erweiterung hinzufügen
• Ihrem Projekt eine benutzerdefinierte Visualisierung hinzufügen

Hinweis: Modelllokalisierung ist nicht mit dem Projektimport kompatibel.

Jedes Projekt kann nur über eine Manifestdatei verfügen, und diese muss mit manifest.lkml benannt und auf der Root-Ebene der Verzeichnisstruktur Ihres Projekts und in Ihrem Git-Repository abgelegt sein.

Auf der Seite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Projektmanifestdateien.

Manifest-Sperrbildschirmdateien

Manifest-Sperrbalken werden automatisch erstellt, wenn der Manifestdatei des Projekts eine Remote-Abhängigkeit hinzugefügt wird. Looker verwendet die Manifest-Sperrbildschirmdatei, um die Version der Remote-Projekte zu verfolgen, die in der Manifestdatei angegeben sind. Die Manifest-Sperre wird im Dateibrowser der Looker IDE aufgeführt und hat den Dateinamen manifest_lock.lkml.

Looker-Entwickler müssen keine Manifest-Sperrbildschirmdatei erstellen oder bearbeiten, da Sperrdateien automatisch von Looker verwaltet werden.

Weitere Informationen finden Sie auf der Dokumentationsseite Dateien aus anderen Projekten importieren.

Dateien mit Sprachstrings

Wenn Sie Ihr Datenmodell lokalisieren, müssen Sie für jedes Gebietsschema, in das Sie lokalisieren möchten, Gebietsschema-Zeichenfolgendateien erstellen, einschließlich des Standardgebietsschemas (z. B. Englisch in den USA).

In Gebietsschema-Zeichenfolgendateien sind Schlüssel/Wert-Paare für jedes Label und jede Beschreibung aufgeführt, die Sie in Ihrem Modell lokalisieren. Die Zeichenfolgendatei für jedes Gebietsschema sollte die Übersetzung für jedes Label oder jede Beschreibung für dieses Gebietsschema enthalten. Weitere Informationen zum Erstellen von Gebietsschema-Zeichenfolgendateien finden Sie auf der Dokumentationsseite LookML-Modell lokalisieren.

Auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Dateien mit Sprachstrings.

Dateien ansehen

Ein Explore ist eine Ansicht, zu der Nutzer Abfragen erstellen können. Ein Explore ist der Ausgangspunkt für eine Abfrage. In einer SQL-Anweisung entspräche dies dem FROM. Auf der Seite Explores in Looker aufrufen und damit interagieren finden Sie Informationen dazu, wie Nutzer mit Explores interagieren, um Daten abzufragen.

Explores werden in der Regel in einer Modelldatei definiert. Manchmal benötigen Sie jedoch eine separate Explore-Datei für eine abgeleitete Tabelle oder um ein Explore zu erweitern oder zu verfeinern, das mehrere Modelle umfasst.

Auf der Seite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Explore-Dateien.

Testdateien für Daten

Ihr Projekt enthält möglicherweise Datentestdateien, mit denen die Logik Ihres LookML-Modells überprüft 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 Datei zu speichern.

Auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Datentestdateien.

Dateien mit Optimierungen

Ihr Projekt enthält möglicherweise Dateien, die für LookML-Verfeinerungen verwendet werden. Mit LookML-Optimierungen können Sie eine vorhandene Ansicht oder ein Explore anpassen, ohne die zugehörige LookML-Datei zu bearbeiten. LookML-Verfeinerungen können in Modell-, Ansichts- oder Explore-Dateien oder in einer eigenen Datei enthalten sein.

Auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten finden Sie eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Dateien für Verfeinerungen.

Sonstige Dateien

Viele LookML-Elemente können in verschiedenen Dateien in Ihrem Projekt oder in eigenen Dateien gespeichert werden. Datentests können beispielsweise in Modelldateien, Ansichtsdateien oder eigenen .lkml-Dateien gespeichert werden.