Modell generieren

Auf dieser Seite wird beschrieben, wie Sie ein neues Projekt erstellen und automatisch ein Basismodell aus Ihrer Datenbank generieren.

Es gibt weitere Möglichkeiten, 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 dazu finden Sie auf der Seite Neues LookML-Projekt erstellen.

Modell aus Ihrer Datenbank automatisch 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 Entwickeln die Option 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 alle Ihre Projekte zusammen mit den jeweiligen 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:

    • Benennen Sie das Projekt.
    • Wählen Sie unter Start die Option Modell aus Datenbankschema generieren aus.
    • Wählen Sie im Drop-down-Menü Verbindung den Namen der Datenbankverbindung aus.
    • Wählen Sie unter Build-Ansichten aus eine Option 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 auswählen, geben Sie den Namen der Datenbanktabelle ein.
    • Geben Sie den Namen des Schemas in das Textfeld Schemas ein, um nur Dateien für ein Schema in Ihrer Datenbank zu generieren. Sie können mehrere durch Kommas getrennte Schemas auflisten.
    • Wenn Sie die Präfixe der Tabellen aus den Dateinamen der Ansicht ausschließen möchten, geben Sie die Präfixe Ihrer Datenbank in das Textfeld Präfixe ignorieren ein. Bei diesem Feld wird zwischen Groß- und Kleinschreibung unterschieden. Sie können mehrere Präfixe durch Kommas getrennt 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 wird das neue Projekt in Looker in der Looker-IDE geöffnet.
    • Der LookML-Generator erstellt IDE-Ordner für Ihre Ansichts- und Modelldateien. Wenn die 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, werden die Feldbeschreibungen von Looker gegebenenfalls automatisch mit den Beschreibungen aus den BigQuery-Spaltenmetadaten ausgefüllt.

Der Generator erstellt für jede Datenbanktabelle außerdem ein Explore. Wenn Sie mit dem Abfragen Ihrer Daten beginnen möchten, wählen Sie im Bereich Erkunden den Namen eines explorativen Analysetools aus.

Wie Sie ein Projekt nach dem Erstellen umbenennen, erfahren Sie auf der Seite 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 Modell- und Dateidateien beschrieben. Außerdem können Sie sie für die Produktion konfigurieren. Weitere Informationen finden Sie im Abschnitt Modelle konfigurieren auf dieser Seite. Weitere Informationen finden Sie auf der Seite Neues LookML-Projekt erstellen.

Nachdem Ihre Modelldateien generiert oder manuell erstellt wurden, lesen Sie die Dokumentation zum Einrichten und Testen einer Git-Verbindung. Dort finden Sie Informationen zum Verbinden Ihres Looker-Projekts mit Git. Sie können Änderungen an Ihren LookML-Dateien erfassen und Versionen Ihrer Dateien verwalten.

Verbesserte LookML-Generierung

Wenn Ihr Looker-Administrator das Labs-Feature 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.
  • In Looker werden der Modelldatei und jeder Ansichtsdatei mehrere Erläuterungen zu Inline-Kommentaren hinzugefügt.
  • Wenn eine Ansicht mindestens eine Dimension von type: number enthält, die nicht den String id im Namen enthält, erstellt Looker ein Maß für type: sum und ein Maß von type: average. Beide basieren auf der alphabetisch ersten Dimension von type: number, die nicht den String id im Namen enthält.

Modelle konfigurieren

Das Konfigurieren 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.
  • Legt die Verbindungen fest, die das Modell verwenden darf.

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

Ein LookML-Entwickler gibt die gewünschte Verbindung in der Modelldatei an, aber ein Administrator steuert, welche Verbindungen auf der Seite LookML-Projekte zulässig sind. Wenn für ein Modell eine Verbindung angegeben 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 fehl, die sich im Produktionsmodus des Modells befinden. 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 konfiguriertes Modell mit demselben Namen in einem anderen Projekt haben, wird es in Looker nicht automatisch konfiguriert.
  • Während der Entwicklung. Wenn Sie Entwickler haben, denen nicht die manage_models-Berechtigung gewährt wurde (die in der Rolle admin enthalten ist), 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 Abfragen für ein nicht konfiguriertes Modell im Entwicklungsmodus ausführen. Dazu sucht Looker nach Projekten mit diesem Namen. Das erste Modell mit diesem Namen wird zum Ausführen der Abfrage verwendet.