LookML-Modell generieren

Auf dieser Dokumentationsseite wird beschrieben, wie Sie mit der Seite Modell erstellen automatisch ein einfaches LookML-Modell aus Ihrer Datenbankverbindung generieren. Die Seite Modell erstellen kann auch verwendet werden, um ein Projekt zu erstellen, in dem sich Ihr Modell befindet.

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 Legacy-Methode zum Erstellen von Projekten und Generieren von Modellen verwenden, indem Sie auf eine der folgenden Optionen klicken, die Sie zur Legacy-Seite Neues Projekt weiterleiten:

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

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

Auf die Seite Modell erstellen zugreifen

Sie können auf folgende Arten auf die Seite Modell erstellen zugreifen:

Um auf die Seite Modell erstellen zuzugreifen, müssen Sie sich im Entwicklungsmodus befinden.

Sie müssen ein Looker-Administrator sein oder die Berechtigung develop haben, um auf die Seite Modell erstellen zuzugreifen.

Über den Bereich Entwickeln

So greifen Sie über den Bereich Entwickeln auf die Seite Modell erstellen zu:

  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 sehen, auf die Sie Zugriff haben, sowie die zugehörigen Modelle. Wählen Sie auf der Seite LookML-Projekte die Schaltfläche Neues Modell aus, um die Seite Modell erstellen zu öffnen.

Über die Schaltfläche Erstellen

So greifen Sie über die Schaltfläche Erstellen auf die Seite Modell erstellen zu:

  1. Klicken Sie im Hauptnavigationsmenü auf die Schaltfläche Erstellen.
  2. Wählen Sie im Drop-down-Menü LookML-Modell aus. Dadurch 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 zum nächsten Abschnitt zu wechseln.

  1. Datenbankverbindung auswählen:

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

    • Wenn Sie Zugriff auf Projekte haben, die die Verbindung bereits verwenden, werden sie angezeigt, sobald die Verbindung ausgewählt wurde. 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 diesem Feld einen Projektnamen ein. Bei Projektnamen wird zwischen Groß- und Kleinschreibung unterschieden. Sie dürfen nur alphanumerische Zeichen, _, . und - enthalten. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als permanente ID für das Projekt. Neue Projekte werden mit einem leeren Git-Repository konfiguriert.

    • Wählen Sie das Kästchen Erstellen Sie eine Readme-Datei mit weiteren Informationen zur Verwendung von LookML aus, wenn Looker dem neuen Projekt eine README-Datei hinzufügen 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 zum nächsten Abschnitt zu wechseln.

  2. Tabellen auswählen:

    • Wenn Sie eine BigQuery-Verbindung verwenden, wählen Sie im Drop-down-Menü GCP-Projekt auswählen das Projekt aus, in dem sich das Dataset befindet, oder suchen Sie im Feld Projektnamen suchen nach dem Projekt. Google Cloud Standardmäßig wird das Google Cloud Speicherprojekt im Drop-down-Menü angezeigt, sofern es vorhanden ist. 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, öffnen Sie mit dem Pfeil rechts neben dem Namen des Datasets oder Schemas den Tab Tabellen und wählen Sie alle Tabellen aus, die Sie einbeziehen möchten. Aus den Tabellen werden Ansichten erstellt.
    • Nachdem Sie die Tabellen ausgewählt haben, öffnen Sie mit dem Pfeil rechts neben dem Namen der Tabelle den Tab Felder und wählen Sie 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 auflisten. Beispiel: Ihre Tabellen haben die Titel dwh_orders und DBS_users. Wenn Sie dwh, DBS in das Feld Präfixe ignorieren eingeben, erstellt Looker Ansichtsdateien mit den Namen orders und users.
    • Feldbeschreibungen importieren: Wählen Sie dieses Kästchen aus, 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 zum nächsten Abschnitt zu wechseln.

  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 zum nächsten Abschnitt zu wechseln.

  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 Ansichten aus.
    • Klicken Sie auf die Schaltfläche Weiter , um Ihre Einträge zu speichern und zum nächsten Abschnitt zu wechseln.

  5. Modellname eingeben:

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

    • Abschließen und Modell ansehen: Looker leitet Sie zu den Dateien in der Looker IDE weiter.
    • Abschließen und Daten untersuchen: Looker leitet Sie zum Explore weiter, das der ersten ausgewählten Ansichtsdatei im Bereich Zu erstellende Explores auswählen entspricht.

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

Wann müssen Modelle konfiguriert werden?

Die Konfiguration eines Modells ist aus folgenden Gründen nützlich:

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

Eine Modellkonfiguration ist für Administratoren (oder Entwickler mit der manage_models oder manage_project_models Berechtigung) nicht erforderlich, solange sie sich im Entwicklungsmodus befinden. So können LookML-Entwickler im Entwicklungsmodus arbeiten. Wenn jedoch eine Modellkonfiguration vorhanden ist, werden alle Abfragen durch diese Konfiguration eingeschränkt, auch im Entwicklungsmodus.

Obwohl ein LookML-Entwickler die gewünschte Verbindung in der Modelldatei angibt, steuert ein Administrator auf der Seite LookML-Projekte , welche Verbindungen 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 übertragen wird. Wenn das Modell nicht konfiguriert ist, schlagen alle Abfragen für dieses Modell fehl, sobald sich das Modell im Produktionsmodus befindet. Wenn ein Modell zum ersten Mal vom Entwicklungsmodus in die Produktion übertragen wird, konfiguriert Looker das Modell automatisch, wenn der Name des Modells für die Looker-Instanz eindeutig ist. Wenn Sie jedoch ein konfiguriertes Modell mit demselben Namen in einem anderen Projekt haben, konfiguriert Looker das Modell nicht automatisch.
  • Während der Entwicklung. Wenn Sie Entwickler haben, denen weder die manage_models Berechtigung (die in der admin Rolle enthalten ist) noch die manage_project_models Berechtigung zugewiesen wurde, muss das Modell konfiguriert werden, bevor diese Entwickler Abfragen für dieses 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.

Looker ermöglicht Entwicklern mit der Berechtigung manage_models oder manage_project_models, Abfragen für ein nicht konfiguriertes Modell im Entwicklungsmodus auszuführen. Dazu sucht Looker in Projekten nach einem Modell mit diesem Namen. Das erste Modell mit diesem Namen wird verwendet, um die Abfrage auszuführen.

Geplante Modelle konfigurieren

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

Die Konfiguration eines Modells im Voraus ist nützlich, wenn Entwicklern weder die Berechtigung manage_models noch manage_project_models zugewiesen wurde. Wenn ein Administrator das Modell für die Entwickler konfiguriert, können sie Abfragen ausführen, sobald sie die Modelldatei generieren oder erstellen.

Administratoren können auch angeben, welche Datenbankverbindungen vom Modell verwendet werden können, oder festlegen, dass das Modell alle aktuellen oder zukünftigen Verbindungen verwenden darf. Looker-Entwickler geben mit dem LookML connection-Parameter in der Modelldatei an, welche Verbindung das Modell verwenden soll. Wenn ein Entwickler eine Verbindung angibt, die ein Administrator in der Konfiguration des Modells nicht zugelassen hat, wird keine Abfrage für dieses Modell ausgeführt.

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

Leeres Projekt generieren

Das Erstellen eines leeren Projekts kann nützlich 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 jedoch die Anzahl der generierten LookML-Dateien 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 übrigen Abschnitte leer.

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

Nächste Schritte

Nachdem ein Modell oder Projekt erstellt wurde, können Sie folgende Aktionen ausführen: