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 andere Möglichkeiten, Ihre Projektdateien zu erstellen: Sie können ein leeres Projekt erstellen und das zugehörige Modell manuell erstellen oder ein vorhandenes öffentliches Git-Repository klonen. Weitere Informationen finden Sie auf der Dokumentationsseite Neues LookML-Projekt erstellen.

Modell automatisch aus Ihrer Datenbank generieren

  1. Klicken Sie in der Menüleiste auf Entwickeln und prüfen Sie, ob Sie sich im Entwicklungsmodus befinden.

  2. Wählen Sie im Navigationsbereich unter 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 samt den zugehörigen Modellen ansehen. Auf dieser Seite können Sie 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 lokalen Projektimport zu identifizieren.
      • So rufen Sie das Projekt auf der Seite LookML-Projekte auf:
      • So rufen Sie das Projekt im Looker-Navigationsbereich unter Entwickeln auf.
      • Teil der URL für Projektdateien. Auf einer Looker-Instanz mit der URL example.looker.com finden Sie die Projektmanifestdatei für das Projekt ecommerce beispielsweise unter dieser 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.

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

      • Alle Tabellen: Der LookML-Generator erstellt für jede Tabelle in Ihrer Datenbank eine Ansichtsdatei.
      • 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 für nur ein Schema in Ihrer Datenbank zu generieren, geben Sie den Namen des Schemas in das Textfeld Schemas ein. Sie können mehrere Schemas auflisten, die durch Kommas getrennt sind.

    • Präfixe ignorieren: Wenn Sie Tabellenpräfixe aus den Dateinamen der Ansicht ausschließen 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 haben beispielsweise die Titel 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 für BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, füllt Looker Feldbeschreibungen automatisch mit den Beschreibungen aus den BigQuery-Spaltenmetadaten, falls vorhanden.

Der Generator erstellt außerdem für jede Datenbanktabelle ein Explore. Wenn Sie eine Datenabfrage starten möchten, wählen Sie im Bereich Explore den Namen eines Explores aus.

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

Sie können zusätzliche neue Modelle für Ihr Projekt manuell erstellen, wie auf der Dokumentationsseite Grundlegendes zu Modell- und Anzeigedateien beschrieben. Konfigurieren Sie sie für die Verwendung in der Produktion, wie im Abschnitt Wenn Sie Modelle konfigurieren müssen auf dieser Seite beschrieben. Weitere Informationen finden Sie auf der Dokumentationsseite Neues LookML-Projekt erstellen.

Nachdem Ihre 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 Ihrer Dateien verwalten.

Verbesserte LookML-Generierung

Wenn Ihr Looker-Administrator die Labs-Funktion Verbesserte LookML-Generierung 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 für neue LookML-Entwickler.
  • Looker fügt der Modelldatei und jeder Ansichtsdatei mehrere Inline-Kommentarerklärungen hinzu.
  • Wenn eine Ansicht mindestens eine Dimension 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 alphabetischen 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.

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

Obwohl ein LookML-Entwickler die beabsichtigte Verbindung in der Modelldatei angibt, legt ein Administrator auf der Seite LookML-Projekte fest, welche Verbindungen zulässig 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.

Ein Modell muss in den folgenden Szenarien 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 es sich im Produktionsmodus befindet. Wenn ein Modell zum ersten Mal aus dem 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 Modell mit demselben Namen in einem anderen Projekt konfiguriert haben, konfiguriert Looker das Modell nicht automatisch.
  • Während der Entwicklung. Wenn Sie Entwickler haben, denen weder die Berechtigung manage_models (in der Rolle admin) 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 existiert oder bevor das Projekt existiert. Wenn 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 im Entwicklungsmodus Abfragen für ein nicht konfiguriertes Modell ausführen. Zu diesem Zweck sucht Looker in Projekten nach einem Modell mit diesem Namen. Das erste Modell mit diesem Namen wird zum Ausführen der Abfrage verwendet.