LookML-Modell generieren

Auf dieser Dokumentationsseite wird beschrieben, wie Sie auf der Seite Modell erstellen automatisch ein grundlegendes LookML-Modell aus Ihrer Datenbankverbindung generieren. Auf der Seite Modell erstellen können Sie auch ein Projekt erstellen, in dem Ihr Modell gespeichert wird.

Es gibt auch andere Möglichkeiten, Modelldateien zu erstellen:

  • Sie können Modelldateien und andere Projektdateien manuell in der IDE erstellen.

  • Sie können die bisherige Methode zum Erstellen von Projekten und Generieren von Modellen verwenden, indem Sie auf eine der folgenden Optionen klicken, die Sie zur bisherigen Seite Neues Projekt weiterleiten:

    • über den Link im Banner oben auf der Seite Modell erstellen
    • über die Schaltfläche LookML hinzufügen im Bereich Ausstehende Projekte auf der Seite Projekte

    Folgen Sie auf der Seite Neues Projekt der Anleitung in der Dokumentation Neues LookML-Projekt erstellen.

Seite Modell erstellen aufrufen

Sie haben folgende Möglichkeiten, auf die Seite Modell erstellen zuzugreifen:

Sie müssen sich im Entwicklungsmodus befinden, um auf die Seite Modell erstellen zugreifen zu können.

Um auf die Seite Modell erstellen zugreifen zu können, müssen Sie Looker-Administrator sein oder die Berechtigung develop haben.

Über den Abschnitt Entwickeln

Führen Sie die folgenden Schritte aus, um im Bereich Entwickeln auf die Seite Modell erstellen zuzugreifen.

  1. Klicken Sie im linken Navigationsbereich auf Entwickeln.

  2. Wählen Sie im Navigationsbereich im Bereich Entwickeln die Option Projekte aus.

  3. Dadurch wird die Seite LookML-Projekte geöffnet. Auf der Seite LookML-Projekte können Sie alle Projekte, auf die Sie Zugriff haben, sowie die zugehörigen Modelle aufrufen. Klicken Sie auf der Seite LookML-Projekte auf die Schaltfläche Neues Modell, um die Seite Modell erstellen zu öffnen.

Über die Schaltfläche Erstellen

Führen Sie die folgenden Schritte aus, um über die Schaltfläche Erstellen auf die Seite Modell erstellen zuzugreifen.

  1. Klicken Sie im Hauptnavigationsmenü auf die Schaltfläche Erstellen.
  2. Wählen Sie im Drop-down-Menü die Option LookML-Modell aus. Daraufhin wird die Seite Modell erstellen geöffnet.

Modell generieren

Die Seite Modell erstellen ist in Abschnitte unterteilt. Führen Sie die Schritte in den folgenden Abschnitten aus, um ein Modell zu generieren. Klicken Sie nach jedem Abschnitt auf Weiter, um Ihre Eingabe zu speichern und mit dem nächsten Abschnitt fortzufahren.

  1. Datenbankverbindung auswählen:

    • Datenbankverbindung auswählen: Wählen Sie im Drop-down-Menü eine Datenbankverbindung aus. Sie können auch die Option Neue Verbindung erstellen aus dem Drop-down-Menü auswählen. Daraufhin wird die Seite Datenbank mit Looker verbinden geöffnet, auf der Sie eine neue Verbindung erstellen können.

    • Wenn Sie Zugriff auf Projekte haben, in denen die Verbindung bereits verwendet wird, werden diese angezeigt, sobald die Verbindung ausgewählt ist. Sie können Ihr neues Modell einem vorhandenen Projekt hinzufügen oder ein neues LookML-Projekt für Ihr Modell erstellen.

    • Name des LookML-Projekts: Wenn Sie ein neues LookML-Projekt für das Modell erstellen möchten, geben Sie in dieses Feld einen Projektnamen ein. Projektnamen sind groß- und kleinschreibungsempfindlich und dürfen nur alphanumerische Zeichen, _, . und - enthalten. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als dauerhafte ID für das Projekt. Neue Projekte werden mit einem unbenannten Git-Repository konfiguriert.

    • Klicken Sie das Kästchen Erstellen Sie eine Readme-Datei mit weiteren Informationen zur Verwendung von LookML an, wenn dem neuen Projekt eine README-Datei hinzugefügt werden soll. Die README-Datei enthält eine Einführung in LookML sowie Links und Ressourcen für neue LookML-Entwickler.

    • Klicken Sie auf die Schaltfläche Weiter, um Ihre Einträge zu speichern und mit dem nächsten Abschnitt fortzufahren.

  2. Tabellen auswählen:

    • Wenn Sie eine BigQuery-Verbindung verwenden, wählen Sie im Drop-down-Menü GCP-Projekt auswählen das Google Cloud Projekt aus, in dem sich das Dataset befindet, oder suchen Sie im Feld Projektnamen suchen nach dem Projekt. Standardmäßig wird das Google Cloud Speicherprojekt im Drop-down-Menü angezeigt, sofern vorhanden. Andernfalls wird das Google Cloud Abrechnungsprojekt angezeigt.
    • Wählen Sie in der Tabelle die Datasets (BigQuery) oder Schemas (andere Dialekte) aus, die im Modell verwendet werden sollen.
    • Nachdem Sie die Datasets oder Schemas ausgewählt haben, klicken Sie auf den Pfeil rechts neben dem Namen des jeweiligen Datasets oder Schemas, um den Tab Tables (Tabellen) zu öffnen. Wählen Sie dann alle Tabellen aus, die Sie einbeziehen möchten. Aus den Tabellen werden Ansichten erstellt.
    • Nachdem Sie die Tabellen ausgewählt haben, klicken Sie auf den Pfeil rechts neben dem Namen jeder Tabelle, um den Tab Felder zu öffnen. Wählen Sie dann alle Felder aus, die Sie einbeziehen möchten.
    • Präfixe ignorieren: Wenn die Tabellenpräfixe in den generierten Ansichtsdateinamen ignoriert werden sollen, geben Sie die Präfixe der Datenbank in diesem Feld in einer durch Kommas getrennten Liste ein. Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Sie können mehrere Präfixe durch Kommas getrennt angeben. Angenommen, Ihre Tabellen heißen dwh_orders und DBS_users. Wenn Sie dwh, DBS in das Feld Prefixe ignorieren eingeben, erstellt Looker Ansichtsdateien mit den Namen orders und users.
    • Feldbeschreibungen importieren: Aktivieren Sie dieses Kästchen, um alle verfügbaren Feldbeschreibungen in der Datenbank als LookML-Beschreibungen für generierte Dimensionen zu verwenden.
    • Klicken Sie auf die Schaltfläche Weiter, um Ihre Einträge zu speichern und mit dem nächsten Abschnitt fortzufahren.

  3. Primärschlüssel auswählen:

    • Wählen Sie für jede ausgewählte Tabelle einen Primärschlüssel aus. Damit lassen sich Ihre Tabellen mit Looker besser verknüpfen.
    • Dieser Schritt ist optional. Wenn Sie ihn überspringen möchten, wählen Sie keine Primärschlüssel aus.
    • Klicken Sie auf die Schaltfläche Weiter, um Ihre Einträge zu speichern und mit dem nächsten Abschnitt fortzufahren.

  4. Zu erstellende Explores auswählen:

    • Wählen Sie alle Ansichten aus, die Sie als Basisansicht für ein Explore verwenden möchten. Für jede ausgewählte Ansicht werden automatisch so viele weitere Datenansichten wie möglich zusammengeführt. Es können für einen Join nur Ansichten mit einem Primärschlüssel verwendet werden, der im vorherigen Schritt ermittelt wurde.
    • Dieser Schritt ist optional. Wenn Sie ihn überspringen möchten, wählen Sie keine Datenansichten aus.
    • Klicken Sie auf die Schaltfläche Weiter, um Ihre Einträge zu speichern und mit dem nächsten Abschnitt fortzufahren.

  5. Modellname eingeben:

  6. Klicken Sie auf eine der folgenden Schaltflächen, um die Modelldateien und, falls ausgewählt, das neue Projekt zu generieren:

    • Modell vervollständigen und ansehen: In Looker werden Sie zu den Dateien in der Looker IDE weitergeleitet.
    • Daten ergänzen und analysieren: In Looker wird das Explore geöffnet, das der ersten ausgewählten Ansichtsdatei im Bereich Zu erstellende Explores auswählen entspricht.

  7. Wenn Sie ein neues Projekt erstellt haben und es mit einem anderen Repository als dem Bare Git-Repository verbinden möchten, das Looker für die Projekterstellung verwendet hat, klicken Sie auf der Seite Projekteinstellungen des Projekts auf dem Tab Konfiguration auf die Schaltfläche Git-Verbindung zurücksetzen, um den Vorgang abzuschließen.

Wenn Sie Modelle konfigurieren müssen

Das Konfigurieren eines Modells ist aus folgenden Gründen sinnvoll:

  • Sie gibt an, dass sich ein bestimmter Modellname auf ein bestimmtes Modell in einem bestimmten Projekt bezieht.
  • Hier werden die Verbindungen festgelegt, die das Modell verwenden darf.

Für Administratoren (oder Entwickler mit der Berechtigung manage_models oder manage_project_models) ist im Entwicklungsmodus keine Modellkonfiguration erforderlich. So können LookML-Entwickler im Entwicklungsmodus arbeiten. Wenn jedoch eine Modellkonfiguration vorhanden ist, sind alle Abfragen auch im Entwicklungsmodus durch diese Konfiguration eingeschränkt.

Ein LookML-Entwickler gibt die beabsichtigte Verbindung in der Modelldatei an, aber ein Administrator steuert, welche Verbindungen auf der Seite LookML-Projekte zulässig sind. Wenn in einem Modell die Verwendung einer Verbindung angegeben ist, die in der Konfiguration des Modells nicht zulässig ist, ist die Verbindung nicht zulässig.

In den folgenden Fällen muss ein Modell eine Konfiguration haben:

  • Wenn ein Modell zum ersten Mal in die Produktion verschoben wird. Wenn das Modell nicht konfiguriert ist, schlagen alle Abfragen auf dieses Modell fehl, sobald es sich im Produktionsmodus befindet. Wenn ein Modell zum ersten Mal aus dem Entwicklungsmodus in die Produktion verschoben wird, wird es von Looker automatisch konfiguriert, wenn der Name des Modells für die Looker-Instanz eindeutig ist. Wenn Sie jedoch in einem anderen Projekt ein konfiguriertes Modell mit demselben Namen haben, wird es in Looker nicht automatisch konfiguriert.
  • Während der Entwicklung. Wenn Entwickler weder die Berechtigung manage_models (die in der Rolle admin enthalten ist) noch die Berechtigung manage_project_models haben, muss das Modell konfiguriert werden, bevor diese Entwickler Abfragen für das Modell ausführen können. Sie können das Modell konfigurieren, bevor es oder das Projekt vorhanden ist. Wenn ein LookML-Entwickler dann das Modell erstellt, sind die zulässigen Verbindungen des Modells bereits konfiguriert und der Entwickler kann Abfragen erfolgreich ausführen.

In Looker können Entwickler, die die Berechtigung manage_models oder manage_project_models haben, im Entwicklungsmodus Abfragen auf ein nicht konfiguriertes Modell ausführen. Dazu sucht Looker in Projekten nach einem Modell mit diesem Namen. Die Abfrage wird mit dem ersten Modell ausgeführt, das mit diesem Namen gefunden wird.

Geplante Modelle konfigurieren

Über die Schaltfläche Neues Modell konfigurieren oben auf der Seite LookML-Projekte können Looker-Administratoren eine Konfiguration für ein vorhandenes Modell oder für ein geplantes Modell hinzufügen, das noch nicht existiert.

Das Konfigurieren eines Modells im Voraus ist hilfreich, wenn Entwickler weder die Berechtigung manage_models noch die Berechtigung manage_project_models haben. Wenn ein Administrator das Modell für die Entwickler konfiguriert, können diese Abfragen ausführen, sobald sie die Modelldatei generiert oder erstellt haben.

Administratoren können auch angeben, welche Datenbankverbindungen vom Modell verwendet werden dürfen, oder festlegen, dass das Modell alle aktuellen oder zukünftigen Verbindungen verwenden darf. Looker-Entwickler verwenden den LookML-Parameter connection, um in der Modelldatei anzugeben, welche Verbindung das Modell verwenden soll. Wenn ein Entwickler eine Verbindung angibt, die ein Administrator in der Modellkonfiguration nicht zugelassen hat, werden keine Abfragen für dieses Modell ausgeführt.

Wenn ein Administrator ein neues Modell im Voraus konfiguriert und im Rahmen dieser Konfiguration ein neues Projekt erstellt, wird dieses Projekt auf der Seite Projekte im Bereich Ausstehende Projekte angezeigt.

Leeres Projekt erstellen

Das Erstellen eines leeren Projekts kann hilfreich sein, wenn Sie Ihre LookML-Dateien von Grund auf neu erstellen möchten.

Auf der Seite Modell erstellen werden Projekte mit LookML-Dateien generiert. Sie können die Anzahl der generierten LookML-Dateien jedoch minimieren, indem Sie auf der Seite Modell erstellen nur die folgenden Abschnitte ausfüllen:

  • Datenbankverbindung auswählen
  • Tabellen auswählen
  • Modellname eingeben

Lassen Sie die restlichen Abschnitte leer.

Klicken Sie auf die Schaltfläche Modell fertigstellen und ansehen. Daraufhin gelangen Sie zum Projekt in der Looker-IDE. In der IDE können Sie alle nicht benötigten LookML-Dateien löschen, um ein leeres Projekt zu erstellen.

Nächste Schritte

Nachdem ein Modell oder Projekt erstellt wurde, haben Sie folgende Möglichkeiten: