Dateitypen in einem LookML-Projekt

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 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 sind jedoch in der IDE-Liste 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:

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 ein Ausgangspunkt zum Abfragen Ihrer Daten. In SQL-Begriffen 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 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
  }
}

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.

Die Ansichten „Distribution Center“, „Inventory Items“ und „Products“ können über den Field Picker für das Explore „Inventory Items Explore“ aufgerufen werden.

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. Die Ansichtsdatei gibt eine Tabelle an, die abgefragt werden soll, und die Felder (Dimensionen und Kennzahlen), die aus dieser Tabelle enthalten sein sollen, damit Benutzer Abfragen mit diesen Feldern in der Looker-Benutzeroberfläche 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

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. In Looker werden die meisten davon 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 einen Filter für Ihre Nutzer mit Filterfeldern festlegen. Auf der Seite Ansichtsparameter finden Sie weitere Informationen zu LookML-Parametern in Ansichtsdateien. 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 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.

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 nicht den Entwicklerbereich von Looker aufrufen müssen, um sie zu erreichen.

Navigationsstruktur in ein Dokument einfü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 (---).

Im Navigationsbereich können Sie die folgenden Parameter verwenden:

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 der Seitenleiste werden Dokument 4, Dokument 1, Dokument 3 und Dokument 2 in alphabetischer Reihenfolge zusammen mit einem Dokument mit dem Titel „Nicht anzeigen“ aufgeführt.

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
---

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

In der Seitenleiste werden die Dokumente in numerischer Reihenfolge aufgelistet und das Dokument wird nicht mehr 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 Navigationsleisten zu ändern:

---
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 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:

Die Seite „document_two“ wird in der Seitenleiste als benutzerdefiniertes Label für Dokument 2 aufgeführt.

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 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 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 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:

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.

Eine Anleitung zum Erstellen von LookML-Projektdateien, einschließlich Projektmanifestdateien, finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.

Manifest-Sperrbalkendateien

Manifest-Sperrbalken 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-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.

Datei 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).

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 für jedes Label oder jede Beschreibung für dieses Gebietsschema enthalten. Weitere Informationen zum Erstellen von Gebietsschema-Zeichenfolgendateien finden Sie auf der Seite 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. Auf der Dokumentationsseite Explores in Looker aufrufen und damit interagieren finden Sie Informationen dazu, wie Nutzer mit Explores interagieren, um Daten abzufragen.

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 extend oder verfeinern zu können.

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

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 Datei zu speichern.

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

Dateien für Suchfilter

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 ihrer eigenen, dedizierten Datei enthalten sein.

Anleitungen 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 Dateien gespeichert werden. Datentests können beispielsweise in Modell-, Ansichtsdateien oder in eigenen .lkml-Dateien gespeichert werden.