Daten in LookML modellieren

Mit LookML und der Looker-IDE können Sie wiederverwendbare Datenmodelle, Dimensionen und Beziehungen definieren, die auf Ihren Datenbanktabellen basieren. In dieser Kurzanleitung erstellen Sie eine Modell- und eine Ansichtsdatei, konfigurieren ein Explore und testen eine neue Dimension mit dem LookML-Beispielprojekt in Looker (Google Cloud Core). Außerdem erfahren Sie, wie Sie den Entwicklungsmodus aktivieren, in der Looker-IDE navigieren und die Soforthilfe verwenden.

Hinweis

Für diese Kurzanleitung benötigen Sie Folgendes:

  • Zugriff auf eine Looker-Instanz (Google Cloud Core):

Erforderliche Rollen

Für diese Kurzanleitung benötigen Sie die entsprechende IAM-Rolle (Identity and Access Management) und Looker-Rolle.

Identitäts- und Zugriffsverwaltungsrollen

Ihr Looker (Google Cloud Core)-Administrator gewährt Ihnen über das Identity and Access Management-System von Google CloudZugriff auf die Looker (Google Cloud Core)-Anwendung.

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Looker-Instanznutzer (roles/looker.instanceUser) für das Google Cloud Projekt zuzuweisen, das die Looker (Google Cloud Core)-Instanz enthält, um die Berechtigung zu erhalten, die Sie für den Zugriff auf die Looker (Google Cloud Core)-Anwendung benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung looker.instances.login, die für den Zugriff auf die Looker (Google Cloud Core)-Anwendung erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Looker-Berechtigungen

Sie benötigen ein Looker-Nutzerkonto mit der Rolle Looker-Administrator oder der Berechtigung develop.

Entwicklungsmodus aktivieren

Looker-Projekte können in einem von zwei Modi existieren: Produktionsmodus und Entwicklungsmodus. Im Entwicklungsmodus können Sie Änderungen an LookML-Dateien vornehmen und eine Vorschau der Auswirkungen auf Inhalte in Ihrer Instanz ansehen, ohne die Produktionsumgebung (was andere Nutzer sehen) zu beeinträchtigen. Weitere Informationen finden Sie auf der Dokumentationsseite Entwicklungsmodus und Produktionsmodus.

In dieser Kurzanleitung verwenden Sie den Entwicklungsmodus, um Änderungen an den LookML-Dateien vorzunehmen und diese in einem Explore zu testen.

So aktivieren Sie den Entwicklungsmodus:

  1. Klicken Sie auf der Looker (Google Cloud Core)-Startseite auf das Looker-Symbol Hauptmenü , um das Hauptnavigationsmenü zu maximieren, falls es noch nicht maximiert ist.
  2. Wählen Sie unten im Menü die Ein/Aus-Schaltfläche Entwicklungsmodus aus.

Ist der Entwicklungsmodus aktiviert, wird in Looker am oberen Bildschirmrand das Banner Entwicklungsmodus angezeigt.

Ein LookML-Projekt ist eine Sammlung von LookML-Dateien, die Looker mitteilen, wie eine Verbindung zu Ihrer Datenbank hergestellt, wie Ihre Daten abgefragt und wie die Daten in der Benutzeroberfläche dargestellt werden sollen. In dieser Kurzanleitung verwenden Sie das LookML-Beispielprojekt, das automatisch auf Looker (Google Cloud Core)-Instanzen konfiguriert wird.

So rufen Sie die LookML-Beispielprojektdateien in der Looker-IDE auf:

  1. Klicken Sie auf das Looker-Symbol für das Hauptmenü  und wählen Sie Entwickeln aus, falls das Menü Entwickeln nicht bereits angezeigt wird.
  2. Wählen Sie im Menü Entwickeln die Option sample_thelook_ecommerce aus.

Looker öffnet den Dateibrowser der Looker-IDE und zeigt die LookML-Beispielprojektdateien an.

Neuen Projektordner erstellen

Damit die Dateien, die Sie in dieser Kurzanleitung erstellen, von den anderen Dateien im LookML-Beispielprojekt getrennt bleiben, erstellen Sie einen neuen Projektordner für die Kurzanleitungsdateien.

So erstellen Sie einen Ordner in Ihrem Projekt:

  1. Klicken Sie im Bereich Dateibrowser der Looker-IDE oben auf das Symbol Datei oder Ordner hinzufügen  und wählen Sie im Menü Datei oder Ordner hinzufügen die Option Ordner erstellen aus.

  2. Geben Sie als Name des neuen Ordners quickstart ein.

  3. Klicken Sie auf Erstellen.

Looker fügt den neuen Ordner dem Bereich Dateibrowser in der Looker-IDE hinzu.

Weitere Informationen zu IDE-Ordnern

Weitere Informationen zur Verwendung von Ordnern in Ihrem LookML-Projekt finden Sie auf den folgenden Dokumentationsseiten:

Neue LookML-Modelldatei erstellen

In einer LookML-Modelldatei werden eine Datenbankverbindung und die Gruppe von Looker-Explores angegeben, die diese Verbindung nutzen. Ein Explore ist der Ausgangspunkt für Ihre Nutzer, um Ihre Daten in Looker abzufragen, sobald Ihre Daten in LookML modelliert sind (siehe Explores in Looker ansehen und damit interagieren).

So erstellen Sie eine neue Modelldatei in Ihrem LookML-Projekt:

  1. Wählen Sie im Bereich Dateibrowser der Looker-IDE das Dreipunkt-Menü Ordneroptionen für den Ordner quickstart aus, den Sie im Verfahren Neuen Projektordner erstellen erstellt haben.
  2. Wählen Sie im Menü Ordneroptionen die Option Modell erstellen aus.
  3. Geben Sie im Dialogfeld Datei erstellen den Namen quickstart_practice für die neue Datei ein und klicken Sie dann auf Erstellen. Looker erstellt die Datei quickstart_practice.model im Ordner quickstart und öffnet die neue Datei in der Looker-IDE. Der blaue Punkt neben der Datei im Bereich Dateibrowser zeigt an, dass die Datei neu ist.
  4. Klicken Sie im Bereich Dateibrowser auf den Ordner quickstart, um ihn zu maximieren und die Datei quickstart_practice.model aufzurufen.
  5. Klicken Sie in der Looker-IDE auf die Datei quickstart_practice.model, um sie zu öffnen, falls sie noch nicht geöffnet ist.

Die Datei quickstart_practice.model enthält Beispiel-LookML, das Sie als Ausgangspunkt für Ihr Projekt verwenden können. Sie können die Datei vorerst so lassen, wie sie ist. Später in der Kurzanleitung werden Sie Explores in Ihrer Modelldatei erstellen.

Zusätzliche Informationen zu Modelldateien

Wenn Sie in Zukunft eigene Modelldateien erstellen möchten, beachten Sie die folgenden Ressourcen:

Neue LookML-Ansichtsdatei erstellen

In LookML entspricht eine Ansicht entweder einer einzelnen Tabelle in Ihrer Datenbank oder einer einzelnen abgeleiteten Tabelle. In der Ansichtsdatei werden die abzufragende Tabelle in Ihrer Datenbank und die Felder (Dimensionen und Messwerte) angegeben, die aus dieser Datenbanktabelle einbezogen werden sollen. Nachdem Sie ein Feld in der Ansichtsdatei definiert haben, können Sie den $Substitutionsoperator verwenden, um in anderen Teilen Ihres LookML-Codes auf das Feld zu verweisen. So können Sie das Feld an einer einzigen Stelle definieren und an mehreren Stellen in Ihrem LookML-Projekt verwenden.

Es gibt mehrere Möglichkeiten, eine neue Ansichtsdatei zu erstellen. Am einfachsten ist es jedoch, wenn Looker automatisch eine Ansichtsdatei basierend auf einer vorhandenen Tabelle in Ihrer Datenbank generiert.

So lassen Sie Looker eine neue Ansichtsdatei generieren:

  1. Wählen Sie im Bereich Dateibrowser der Looker-IDE das Dreipunkt-Menü Ordneroptionen für den Ordner quickstart aus, den Sie im Verfahren Neuen Projektordner erstellen erstellt haben.
  2. Wählen Sie im Menü Ordneroptionen die Option Ansicht aus Tabelle erstellen aus.

  3. Klicken Sie auf der Seite Ansichten aus Tabellen erstellen auf das Eingabefeld Benutzerdefinierte Datenbank eingeben und geben Sie bigquery-public-data ein:

    Das Dialogfeld „Ansichten aus Tabellen erstellen“.

  4. Drücken Sie die Eingabetaste, um die öffentlichen BigQuery-Datasets aufzurufen.

  5. Scrollen Sie durch die Liste, bis Sie das Dataset thelook_ecommerce finden.

  6. Klicken Sie auf das Dataset thelook_ecommerce, um es zu maximieren.

  7. Wählen Sie die Tabelle order_items aus.

  8. Klicken Sie unten auf der Seite auf den Button Ansichten erstellen.

Looker zeigt die Ansichtsdatei order_items in der Looker-IDE an. Im Bereich „Dateibrowser“ ist der Ordner quickstart maximiert und die Ansichtsdatei order_items wird mit einem blauen Punkt angezeigt, um darauf hinzuweisen, dass es sich um eine neue Datei handelt.

Zusätzliche Informationen zu Ansichtsdateien

Wenn Sie in Zukunft eigene Ansichtsdateien erstellen möchten, beachten Sie die folgenden Ressourcen:

Soforthilfe für die Looker-IDE

Sie haben jetzt eine LookML-Modelldatei und eine LookML-Ansichtsdatei erstellt. In den nächsten Schritten dieser Kurzanleitung bearbeiten Sie diese Dateien. Bevor Sie mit der Bearbeitung beginnen, sollten Sie sich mit der Soforthilfe der Looker-IDE vertraut machen. Im Bereich Soforthilfe finden Sie Erläuterungen und Optionen für die aktuelle Cursorposition in Ihren LookML-Dateien:

  • Im Editorbereich der IDE können Sie auf die Felder und Parameter in Ihren LookML-Dateien klicken. Im Bereich Soforthilfe werden dann die unterstützten Optionen und Unterparameter für dieses LookML-Element angezeigt.
  • Im Bereich Soforthilfe können Sie auf einen Parameternamen klicken, um die Looker-Dokumentationsseite für diesen Parameter zu öffnen.

Wenn der Bereich Soforthilfe noch nicht geöffnet ist, können Sie ihn öffnen, indem Sie in der Looker-IDE auf das Symbol Soforthilfe klicken:

Explores für Ihre Ansichten erstellen

Nachdem Sie die Verfahren Neue LookML-Modelldatei erstellen und Neue LookML-Ansichtsdatei erstellen ausgeführt haben, können Sie ein Explore für Ihre neue Ansichtsdatei definieren. So können Sie mit Looker die Daten abfragen, die Sie in der Ansichtsdatei modelliert haben.

Explores werden in der Regel in einer Modelldatei definiert. (Sie können eine separate Explore-Datei erstellen, aber für diese Kurzanleitung erstellen Sie das Explore in der Modelldatei.)

In der LookML-Datei, in der Sie ein Explore definieren, müssen Sie den Parameter include verwenden, damit Sie in der Explore-Definition auf die Ansichtsdatei verweisen können. In diesem Verfahren werden diese Schritte beschrieben.

So erstellen Sie ein Explore für die Ansichtsdatei order_items:

  1. Öffnen Sie in der Looker-IDE die Datei quickstart_practice.model.

  2. Ersetzen Sie in der Datei quickstart_practice.model die vorhandene Zeile, die den Parameter include enthält, durch die folgende Zeile:

    include: "/quickstart/order_items.view"

  3. Fügen Sie unter dem Parameter include eine neue Zeile hinzu und geben Sie die folgende LookML ein: none explore: order_items {}

  4. Klicken Sie oben in der Looker-IDE auf den Button Änderungen speichern.

Dieses Explore ist das einfachste Beispiel für ein Explore, mit dem Nutzer die Ansicht order_items abfragen können. Von diesem Ausgangspunkt aus können Sie Ihr Explore auf vielfältige Weise ausbauen.

Weitere Informationen zu Explores

Wenn Sie in Zukunft eigene Explores erstellen und erweitern möchten, beachten Sie die folgenden Ressourcen:

Neues Feld erstellen

Nachdem Sie die Ansichtsdateien im Abschnitt Neue LookML-Ansichtsdatei erstellen dieser Kurzanleitung erstellt haben, können Sie die Felder sehen, die Looker automatisch erstellt hat. Wenn Sie eine Ansichtsdatei erstellen, die auf einer Datenbanktabelle basiert, erstellt Looker automatisch Dimensionen, Dimensionsgruppen und Messwerte:

  • Eine Dimension ist ein Feld, das ein Attribut, einen Fakt oder einen Wert darstellt. Nutzer können sie in einem Explore über die Feldauswahl auswählen und zum Filtern einer Abfrage verwenden. Wenn das Feld nicht in einer Aggregatfunktion wie SUM, COUNT oder ähnlichem enthalten ist, handelt es sich um eine Dimension. Looker erstellt automatisch eine Dimension für jede Spalte in Ihrer Datenbanktabelle.
  • Mit einer Dimensionsgruppe können Sie eine Reihe von zeit- oder dauerbasierten Dimensionen auf einmal erstellen. Die Dimensionsgruppe für eine Zeitstempelspalte enthält beispielsweise einzelne Dimensionen für Datum, Monat, Quartal, Uhrzeit, Woche und Jahr. Looker erstellt automatisch eine Dimensionsgruppe für die zeitbasierten Felder, die Looker in Ihrer Datenbanktabelle erkennt.
  • Ein Messwert ist ein Feld in einem Explore, das messbare Informationen zu Ihren Daten darstellt, z. B. Summen, Anzahlen usw. Ein Messwert wird in einer Ansichtsdatei deklariert und kann ein aggregierter oder nicht aggregierter Typ sein. Looker erstellt automatisch einen Messwert vom Typ type:count für Ihre Ansichtsdatei, was einem COUNT(*) in SQL entspricht.

In diesem Abschnitt erfahren Sie, wie Sie der Ansichtsdatei order_items manuell eine eigene Dimension hinzufügen.

So erstellen Sie manuell eine neue Dimension in der Ansichtsdatei order_items:

  1. Öffnen Sie die Datei quickstarts/order_items.view, falls sie noch nicht geöffnet ist: Klicken Sie im Bereich Dateibrowser der Looker-IDE auf den Ordner quickstart, um ihn zu maximieren, und klicken Sie dann auf die Datei order_items.view, um sie zu öffnen.
  2. Erstellen Sie in der Datei quickstarts/order_items.view eine neue Zeile vor dem ersten dimension-Parameter in der Datei.

  3. Geben Sie in der neuen Zeile dimension ein. Während der Eingabe wird in der Looker-IDE eine Liste möglicher Parameter angezeigt, die mit dem von Ihnen eingegebenen Text beginnen.

    • Verwenden Sie die Pfeiltasten, um in der Vorschlagsliste zur Option dimension zu gelangen.
    • Drücken Sie die Eingabetaste, um den ausgewählten Parameter in Ihre LookML einzufügen. Looker fügt in der neuen Zeile, die Sie erstellt haben, einen neuen dimension-Parameter ein.

  4. Um der neuen Dimension einen Namen zu geben, klicken Sie in der IDE vor {} und geben Sie shipped_to_delivered_days ein.

  5. Klicken Sie in das {}-Element und drücken Sie die Eingabetaste, um eine neue Zeile im {}-Element zu erstellen.

  6. Vervollständigen Sie den LookML-Code für die neue Dimension. Sie können den folgenden LookML-Code entweder kopieren und einfügen oder manuell eingeben, um zu sehen, wie die Looker-IDE Sie dabei unterstützt:

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. Klicken Sie oben in der Looker-IDE auf den Button Änderungen speichern.

Looker speichert die Ansichtsdatei mit der neuen Dimension. Die Zeilennummern der neuen Zeilen in der Datei werden in der Looker-IDE grün schattiert.

Weitere Informationen zu LookML-Feldern

Wenn Sie in Zukunft eigene Felder erstellen möchten, beachten Sie die folgenden Ressourcen:

  • Allgemeine Informationen zu LookML-Feldern finden Sie auf der Dokumentationsseite LookML-Feldreferenz.
  • Informationen zu den Arten von Dimensionen, Filtern und Parametern, die Sie in einer Ansichtsdatei erstellen können, finden Sie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen.
  • Informationen zu den Arten von Measures, die Sie in einer Ansichtsdatei erstellen können, finden Sie auf der Dokumentationsseite Measure-Typen.

Änderungen in der Looker-Benutzeroberfläche ansehen und testen

Wenn Sie die Schritte unter Explores für Ihre Ansichten erstellen ausgeführt haben, um ein Explore für die Ansichtsdatei order_items zu erstellen, wird die neue Dimension in der Looker-Explore-Benutzeroberfläche angezeigt.

So rufen Sie Ihre Änderungen im Explore in der Looker-Benutzeroberfläche auf und testen sie:

  1. Klicken Sie in der Datei quickstarts/order_items.view in der Looker-IDE auf das Pfeilsymbol Dateiaktionen ansehen neben dem Namen der Ansichtsdatei oben im Dateieditor und wählen Sie die Option Bestellpositionen untersuchen – quickstart_practice aus.

    Das Menü „Dateiaktionen ansehen“ mit der ausgewählten Option „Bestellpositionen untersuchen – quickstart_practice“.

  2. Klicken Sie in der Feldauswahl des Explore Bestellpositionen auf das Gruppenlabel Andere Datumsangaben, um es zu maximieren. Klicken Sie dann auf die Dimension Tage zwischen Versand und Lieferung, um sie dem Explore hinzuzufügen. (Sie können auch nach der Dimension suchen, indem Sie Shipped to Delivered Days in das Suchfeld der Feldauswahl eingeben.)

  3. Klicken Sie in der Feldauswahl des Explore Order Items auf das Gruppenlabel Shipped Date, um es zu maximieren, und dann auf die Dimension Date, um sie dem Explore hinzuzufügen.

  4. Klicken Sie in der Feldauswahl des Explore Order Items auf die Gruppenbezeichnung Delivered Date, um sie zu maximieren. Klicken Sie dann auf die Dimension Date, um sie dem Explore hinzuzufügen.

  5. Klicken Sie oben im Explore auf den Button Ausführen.

Looker führt die Abfrage aus und zeigt die Ergebnisse im Abschnitt Daten des Explores an. Sie können für jede Zeile prüfen, ob der Wert in Order Items Shipped to Delivered Days die richtige Anzahl von Tagen zwischen dem Wert für Order Items Shipped Date und dem Wert für Order Items Delivered Date zeigt.

LookML validieren

Für diese Kurzanleitung müssen Sie Ihr LookML nicht validieren. Wenn Sie in Zukunft eigene Projekte zur Modellierung Ihrer Daten erstellen, ist es jedoch gut, die Looker-Tools zur Validierung Ihrer LookML zu kennen.

Wenn Sie Ihre LookML bearbeiten, werden Sie in der Looker-IDE auf alle nicht behobenen Syntaxfehler in einer einzelnen Datei hingewiesen (siehe Dokumentationsseite Looker-IDE – Übersicht). Sie können auch eine vollständige Modellvalidierung durchführen, um Ihre LookML auf Fehler zu prüfen. Weitere Informationen finden Sie auf der Dokumentationsseite LookML validieren.

Änderungen per Commit übernehmen

In dieser Kurzanleitung verwenden Sie eine vorkonfigurierte Git-Verbindung, die für das LookML-Beispielprojekt eingerichtet ist. Wenn Sie jedoch in Zukunft eigene Projekte zur Modellierung Ihrer Daten erstellen, müssen Sie für Ihr Projekt eine Git-Verbindung einrichten.

Wenn Sie Änderungen an den LookML-Projektdateien vornehmen, werden in der Looker-IDE oben rechts verschiedene Vorgänge für den Git-Button angezeigt. Die Schaltfläche zeigt verschiedene Vorgänge an, die Sie durch den Prozess der Validierung Ihrer LookML und der Bereitstellung Ihrer Änderungen in der Produktion führen.

Die LookML-Dateien und das Explore, die Sie in dieser Kurzanleitung aufgerufen haben, sind im Entwicklungsmodus nur in Ihrem persönlichen Git-Branch verfügbar. Wenn Sie dieses Modell anderen Nutzern in Ihrer Looker (Google Cloud Core)-Instanz zur Verfügung stellen möchten, müssen Sie Ihre Änderungen committen, Ihren Branch zusammenführen und den Produktions-Branch bereitstellen.

Im Rahmen dieser Kurzanleitung stellen Sie Ihre Änderungen nicht in der Produktion bereit. Stattdessen löschen Sie diese Dateien, wie im Verfahren Bereinigen beschrieben.

Bereinigen

Um die Leistung von Looker zu maximieren, sollten keine unnötigen Modelle in der Produktion bereitgestellt werden. Damit Ihr persönlicher Git-Branch sauber bleibt und diese Dateien nicht versehentlich in der Produktion bereitgestellt werden, führen Sie die folgenden Schritte aus, um die in dieser Kurzanleitung erstellten Dateien zu löschen:

  1. Klicken Sie auf das Looker-Symbol für das Hauptmenü  und wählen Sie Entwickeln aus, falls das Menü Entwickeln nicht bereits angezeigt wird.
  2. Wählen Sie im Menü Entwickeln die Option sample_thelook_ecommerce aus.
  3. Wählen Sie im Bereich Dateibrowser der Looker-IDE das Dreipunkt-Menü Ordneroptionen für den Ordner quickstart aus, den Sie im Verfahren Neuen Projektordner erstellen erstellt haben.
  4. Wählen Sie im Menü Ordneroptionen die Option Löschen aus.
  5. Klicken Sie im Fenster Ordner löschen auf Löschen.

Looker löscht den Ordner „quickstart“ und alle zugehörigen Inhalte.

Nächste Schritte