Modell generieren

Auf dieser Seite werden die Schritte zum Erstellen eines neuen Projekts und zum automatischen Generieren eines Basismodells aus Ihrer Datenbank beschrieben.

Es gibt weitere Möglichkeiten, Projektdateien zu erstellen: Sie können ein leeres Projekt erstellen und das Modell manuell erstellen oder ein vorhandenes öffentliches Git-Repository klonen. Weitere Informationen dazu finden Sie auf der Dokumentationsseite Neues LookML-Projekt erstellen.

Modell automatisch aus Ihrer Datenbank generieren

Im Bereich Entwickeln von Looker können Sie automatisch ein Modell aus Ihrer Datenbank generieren oder im linken Navigationsbereich auf Erstellen klicken.

Modell im Abschnitt Develop generieren

  1. Klicken Sie im linken Navigationsbereich auf Entwickeln und prüfen Sie, ob Sie sich im Entwicklungsmodus befinden.

  2. Wählen Sie im Navigationsbereich im Abschnitt Develop (Entwickeln) die Option Projects (Projekte) aus.

  3. Wählen Sie auf der Seite LookML-Projekte die Option Neues LookML-Projekt aus:

    • Auf der Seite LookML-Projekte können Sie sich alle Ihre Projekte mit den entsprechenden Modellen ansehen. Auf dieser Seite können Sie Ihre Projekte erstellen, ansehen und konfigurieren.

  4. Geben Sie im Dialogfeld Neues Projekt die Optionen für Ihr Projekt an:

    • Projektname: Geben Sie Ihrem Projekt einen Namen. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als dauerhafte ID für das Projekt, da Looker den Projektnamen auf folgende Weise verwendet:

      • Zur Identifizierung des Projekts für API-Aufrufe mit dem Parameter project_id.
      • Um das Projekt in der internen Datenbank der Looker-Instanz zu identifizieren.
      • Um das Projekt für den Import lokaler Projekte zu identifizieren.
      • So zeigen Sie das Projekt auf der Seite LookML-Projekte an.
      • So können Sie das Projekt im Bereich Develop (Entwickeln) des Looker-Navigationsbereichs anzeigen lassen.
      • Als Teil der URL für Projektdateien. Auf einer Looker-Instanz mit der URL example.looker.com finden Sie beispielsweise die Projektmanifestdatei für das Projekt ecommerce unter der folgenden URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

    • Ausgangspunkt: Wählen Sie Modell aus Datenbankschema generieren aus.

    • Verbindung: Wählen Sie im Drop-down-Menü den Namen Ihrer Datenbankverbindung aus.

    • Build View from (Ansichten erstellen aus): Wählen Sie eine der folgenden Optionen aus:

      • Alle Tabellen: Der LookML-Generator erstellt eine Ansichtsdatei für jede Tabelle in Ihrer Datenbank.
      • Einzelne Tabelle: Der LookML-Generator erstellt eine Ansicht für eine Tabelle in Ihrer Datenbank. Wenn Sie diese Option wählen, geben Sie den Namen der Datenbanktabelle ein.

    • Schemas: Um Dateien nur für ein Schema in der Datenbank zu generieren, geben Sie den Namen des Schemas in das Textfeld Schemas ein. Sie können mehrere Schemas durch Kommas getrennt auflisten.

    • Präfixe ignorieren: Wenn Sie Tabellenpräfixe nicht in den Dateinamen der Ansicht verwenden möchten, geben Sie die Präfixe Ihrer Datenbank in das Feld Präfixe ignorieren ein. Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Sie können mehrere durch Kommas getrennte Präfixe auflisten. Ihre Tabellen heißen beispielsweise dwh_orders und DBS_users. Wenn Sie dwh, DBS in das Textfeld Präfixe ignorieren eingeben, erstellt Looker Ansichtsdateien mit den Namen orders und users.

  5. Klicken Sie auf Projekt erstellen.

    • Der LookML-Generator erstellt eine Modelldatei für das Projekt und eine Ansichtsdatei für jede Tabelle in der Datenbank (sofern nicht anders angegeben). Anschließend öffnet Looker das neue Projekt in der Looker-IDE.
    • Der LookML-Generator erstellt IDE-Ordner für Ihre Ansichts- und Modelldateien. Wenn Ihre Datenbank mehr als ein Schema hat, erstellt der LookML-Generator einen Ordner für Schemas.

Wenn Sie bei BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, fügt Looker die Feldbeschreibungen automatisch mit den Beschreibungen aus den Metadaten der BigQuery-Spalte ein, falls vorhanden.

Der Generator erstellt auch ein Explore für jede Datenbanktabelle. Um mit der Abfrage Ihrer Daten zu beginnen, wählen Sie im Bereich Explore den Namen eines Explore aus.

Informationen dazu, wie Sie Ihr Projekt nach dem Erstellen umbenennen, finden Sie auf der Dokumentationsseite Projektinformationen aufrufen und bearbeiten im Abschnitt Projekt umbenennen.

Sie können zusätzliche neue Modelle für Ihr Projekt manuell erstellen, wie auf der Dokumentationsseite Informationen zu Modellen und zum Anzeigen von Dateien beschrieben. Konfigurieren Sie sie für die Verwendung in der Produktion wie im Abschnitt Wann muss Modelle konfiguriert werden auf dieser Seite beschrieben ist. Weitere Informationen finden Sie auf der Dokumentationsseite Ein neues LookML-Projekt erstellen.

Nachdem die Modelldateien generiert oder manuell erstellt wurden, finden Sie auf der Dokumentationsseite Git-Verbindung einrichten und testen Informationen zum Verbinden Ihres Looker-Projekts mit Git. Sie können Änderungen an Ihren LookML-Dateien aufzeichnen und Versionen der Dateien verwalten.

Modell über die Schaltfläche Erstellen generieren

So erstellen Sie ein Projekt und generieren über die Schaltfläche Erstellen ein Modell:

  1. Klicken Sie im linken Navigationsbereich auf die Schaltfläche Erstellen.
  2. Wählen Sie die Menüoption LookML-Modell aus.
  3. Achten Sie darauf, dass Sie sich im Entwicklermodus befinden.
  4. Im Entwicklungsmodus wird die Seite Projekt erstellen geöffnet.
  5. Wenn Sie Basisansichten für Explores auswählen oder andere erweiterte Optionen anpassen möchten, z. B. Tabellenpräfixe in generierten Ansichtsdateinamen ignorieren, Feldbeschreibungsmetadaten aus der Datenbank importieren, die Erstellung von Modelldateien bestimmen und automatisch generierte Readme-Dateien auswählen, aktivieren Sie die Option Erweiterte Projekterstellung.
  6. Wählen Sie im Drop-down-Menü Datenbankverbindung auswählen eine Datenbankverbindung aus. Wenn Sie Zugriff auf Projekte haben, die die Verbindung bereits verwenden, werden sie angezeigt, sobald die Verbindung ausgewählt wurde. Sie können ein verfügbares Projekt verwenden und ein neues Modell hinzufügen oder ein neues LookML-Projekt erstellen. Wenn Sie das Modell einem Projekt hinzufügen, wird als erster Schritt auf der Seite Projekt erstellen der Abschnitt Modell erstellen angezeigt. Dort können Sie das Modell benennen. Klicken Sie auf Weiter, nachdem Sie Ihre Auswahl getroffen haben.
  7. Wählen Sie im Abschnitt Daten auswählen die Schemas, Tabellen und Felder aus, die im Modell verwendet werden sollen. Ansichten werden aus den Tabellen erstellt. Klicken Sie auf Weiter, nachdem Sie Ihre Auswahl getroffen haben.
  8. Wählen Sie für jede Tabelle einen Primärschlüssel aus. Damit lassen sich Ihre Tabellen mit Looker besser verknüpfen. Klicken Sie auf Weiter, nachdem Sie Ihre Auswahl getroffen haben.
  9. Wenn Sie die Option Erweiterte Projekterstellung aktiviert haben, wählen Sie die Basisansichten für Explores aus. 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. Klicken Sie auf Weiter, nachdem Sie Ihre Auswahl getroffen haben.
  10. Wenn Sie die Option Erweiterte Projekterstellung aktiviert haben, wählen Sie im Abschnitt Erweiterte Optionen Folgendes aus:
    • Präfixe ignorieren: Wenn Sie die Tabellenpräfixe in generierten Ansichtsdateinamen ignorieren möchten, geben Sie die Präfixe der Datenbank in eine durch Kommas getrennte Liste in dieses Feld ein. Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Sie können mehrere durch Kommas getrennte Präfixe auflisten. Ihre Tabellen heißen beispielsweise dwh_orders und DBS_users. Wenn Sie dwh, DBS in das Textfeld Präfixe ignorieren eingeben, erstellt Looker Ansichtsdateien mit den Namen orders und users.
    • Feldbeschreibungen: Klicken Sie das Kästchen Metadaten der Feldbeschreibungen importieren an, um verfügbare Feldbeschreibungen in der Datenbank als LookML-Beschreibungen für generierte Dimensionen zu verwenden.
    • Umgang mit Modelldateien: Wählen Sie aus, ob eine Modelldatei erstellt werden soll. Wenn Sie eine Modelldatei erstellen, geben Sie den gewünschten Namen für die Datei in das Feld Modellname ein.
    • Startleitfaden: Klicken Sie das Kästchen Readme-Datei mit einer Beschreibung der Ausgabe erstellen an, um eine Readme-Datei zu erstellen, in der die Verwendung des Projekts beschrieben wird.
  11. Klicken Sie auf Modell generieren, um die Projektdateien zu generieren. Nachdem Sie die Dateien generiert haben, werden Sie von Looker zu den Dateien in der Looker-IDE weitergeleitet.

Verbesserte LookML-Generierung

Wenn Ihr Looker-Administrator die Labs-Funktion Verbesserte LookML-Generation aktiviert hat, fügt Looker Ihrem Projekt zusätzliche Elemente hinzu, wenn Sie das Projekt aus Ihrer Datenbank generieren:

  • Looker fügt dem neuen Projekt eine README-Datei hinzu. Die README-Datei enthält eine Einführung in LookML sowie Links und Ressourcen zur Unterstützung neuer LookML-Entwickler.
  • Looker fügt der Modelldatei und jeder Ansichtsdatei mehrere Inline-Kommentarerklärungen hinzu.
  • Wenn eine Ansicht mindestens eine Dimension von type: number hat, die nicht den String id im Namen enthält, erstellt Looker einen Messwert von type: sum und einen Messwert von type: average. Beide basieren auf der alphabetisch ersten Dimension von type: number, die nicht den String id im Namen enthält.

Wenn Sie Modelle konfigurieren müssen

Das Konfigurieren eines Modells ist aus folgenden Gründen nützlich:

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

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

Obwohl ein LookML-Entwickler die beabsichtigte Verbindung in der Modelldatei angibt, steuert ein Administrator, welche Verbindungen auf der Seite LookML-Projekte erlaubt sind. Wenn ein Modell angibt, dass eine Verbindung verwendet wird, 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 aus dem Entwicklungsmodus in die Produktion übertragen wird, konfiguriert Looker das Modell automatisch, wenn der Modellname für die Looker-Instanz eindeutig ist. Wenn Sie jedoch ein konfiguriertes Modell mit demselben Namen in einem anderen Projekt haben, wird es von Looker nicht automatisch konfiguriert.
  • Während der Entwicklung. Wenn es Entwickler gibt, denen weder die Berechtigung manage_models (die in der Rolle admin enthalten) noch die Berechtigung manage_project_models gewährt 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 existiert. Wenn dann ein LookML-Entwickler das Projekt und das Modell erstellt, sind die zulässigen Verbindungen des Modells bereits konfiguriert und der Entwickler kann Abfragen erfolgreich ausführen.

Mit Looker können Entwickler mit der Berechtigung manage_models oder manage_project_models Abfragen für ein nicht konfiguriertes Modell im Entwicklungsmodus ausführen. Dazu sucht Looker in Projekten nach einem Modell mit diesem Namen. Das erste Modell mit diesem Namen wird zum Ausführen der Abfrage verwendet.