Neues LookML-Projekt erstellen

Ein Projekt ist eine Sammlung von LookML-Dateien, die beschreiben, in welcher Beziehung Ihre Datenbanktabellen zueinander stehen und wie Looker diese Tabellen interpretieren soll. Weitere Informationen zu Projekten finden Sie auf den Dokumentationsseiten LookML-Projekte und -Entwicklungsmodell und LookML-Begriffe und ‑Konzepte. Informationen zum Zugriff auf und zur Bearbeitung vorhandener Projekte finden Sie auf der Dokumentationsseite Auf Projektinformationen zugreifen und sie bearbeiten.

Ein LookML-Projekt kann mehrere Modelldateien enthalten. Wenn Sie jedoch Berechtigungen für Nutzer festlegen möchten, die das Ansehen und Bearbeiten von LookML für eine bestimmte Modelldatei betreffen, sollten Sie ein neues Projekt erstellen. Die meisten Berechtigungen in Looker gelten zwar auf Modellebene, es gibt aber auch einige Berechtigungen, die auf Projektebene gelten. Dazu gehören see_lookml, mit der Sie sich die LookML für ein Projekt ansehen können, und develop, mit der Sie die LookML bearbeiten können.

Looker-Nutzer mit der Berechtigung manage_models können LookML-Modelle in einer Looker-Instanz erstellen.

Projekt erstellen

So erstellen Sie ein Projekt:

  1. 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, um die Optionen für Ihr Projekt auszuwählen.

Daraufhin wird die Seite Neues Projekt geöffnet, auf der Sie Einstellungen für Ihr Projekt festlegen können, einschließlich des Namens und des Startpunkts des Projekts.

In Looker können Sie ein Projekt auf unterschiedliche Weise erstellen. Die erforderlichen Schritte hängen davon ab, welche Option für den Ausgangspunkt Sie auf der Seite Neues Projekt auswählen. In den folgenden Abschnitten wird beschrieben, wie diese Ausgangspunkte funktionieren:

Automatisches Generieren eines Modells aus Ihrer Datenbank

Legen Sie auf der Seite Neues Projekt die folgenden Optionen fest, um automatisch ein Modell aus einer Datenbank zu generieren.

  1. Project Name (Projektname): Geben Sie einen Namen für Ihr Projekt 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, da der Projektname in Looker auf folgende Weise verwendet wird:

    • Damit wird das Projekt für API-Aufrufe mit dem Parameter project_id identifiziert.
    • Damit wird das Projekt in der internen Datenbank der Looker-Instanz identifiziert.
    • Hiermit wird das Projekt für den lokalen Projektimport angegeben.
    • Das Projekt wird auf der Seite LookML-Projekte angezeigt.
    • Das Projekt wird im Bereich Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. In einer Looker-Instanz mit der URL example.looker.com befindet sich die Projektmanifestdatei für das Projekt ecommerce beispielsweise unter der URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Startpunkt: Wählen Sie Modell aus Datenbankschema generieren aus.

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

  4. 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 auswählen, geben Sie den Namen der Datenbanktabelle ein.

  5. Schemas: Wenn Sie Dateien nur für ein Schema in Ihrer Datenbank generieren möchten, geben Sie den Namen des Schemas in das Textfeld Schemas ein. Sie können mehrere Schemas durch Kommas getrennt auflisten.

  6. Präfixe ignorieren: Wenn Tabellenpräfixe nicht in den Namen der Ansichtsdateien aufgenommen werden sollen, 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 Präfixe durch Kommas getrennt angeben. Angenommen, Ihre Tabellen heißen 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.

Klicken Sie abschließend auf Projekt erstellen, um ein Projekt mit dem generierten Modell zu erstellen.

  • Der LookML-Generator erstellt eine Modelldatei für das Projekt sowie 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, werden die Feldbeschreibungen in Looker automatisch mit den Beschreibungen aus den BigQuery-Spaltenmetadaten ausgefüllt, sofern vorhanden.

Außerdem erstellt der Generator für jede Datenbanktabelle ein Explore. Wählen Sie im Bereich Explore den Namen eines Explores aus, um Daten abzufragen.

Öffentliches Git-Repository klonen

Wenn Sie Öffentliches Git-Repository klonen als Ausgangspunkt auswählen, kopiert Looker die Dateien aus einem öffentlichen Git-Repository in Ihr neues LookML-Projekt.

Looker-Projekte, die aus öffentlichen Git-Repositories geklont werden, sind schreibgeschützt. Sie können das schreibgeschützte Projekt jedoch in ein anderes Looker-Projekt importieren, in dem Sie die Dateien dann bearbeiten können. Außerdem können Sie die geklonten Repositorydateien als Ausgangspunkt verwenden und dann den Looker-Parameter extends oder Optimierungen verwenden, um daraus ein Projekt zu erstellen.

Geben Sie auf der Seite Neues Projekt die folgenden Optionen an, um ein vorhandenes öffentliches Git-Repository in ein Looker-Projekt zu klonen:

  1. Project Name (Projektname): Geben Sie einen Namen für Ihr Projekt ein. Projektnamen sind groß- und kleinschreibungsempfindlich und dürfen keine Leerzeichen oder bestimmte Sonderzeichen enthalten. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als dauerhafte ID für das Projekt, da der Projektname in Looker auf folgende Weise verwendet wird:

    • Damit wird das Projekt für API-Aufrufe mit dem Parameter project_id identifiziert.
    • Damit wird das Projekt in der internen Datenbank der Looker-Instanz identifiziert.
    • Hiermit wird das Projekt für den lokalen Projektimport angegeben.
    • Das Projekt wird auf der Seite LookML-Projekte angezeigt.
    • Das Projekt wird im Bereich Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. In einer Looker-Instanz mit der URL example.looker.com befindet sich die Projektmanifestdatei für das Projekt ecommerce beispielsweise unter der URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Ausgangspunkt: Wählen Sie Öffentliches Git-Repository klonen aus.

  3. Git-Repository-URL: Geben Sie die URL für das öffentliche Git-Repository ein. Die URL muss das Format git://github.com/example/my-repository.git haben.

    Wenn Sie eine URL wie https://github.com/llooker/blocks_redshift_admin haben, können Sie sie im richtigen Format bearbeiten, indem Sie „https://“ durch „git://“ ersetzen und am Ende „.git“ hinzufügen. Die URL, die Sie eingeben würden, wäre git://github.com/llooker/blocks_redshift_admin.git.

Klicken Sie abschließend auf Projekt erstellen. Looker ruft alle Dateien des öffentlichen Repositories in ein neues LookML-Projekt ab und öffnet das Projekt in der Looker IDE.

Leeres Projekt erstellen

Wenn Sie Leeres Projekt als Ausgangspunkt auswählen, wird in Looker ein leeres Projekt erstellt, damit Sie Ihre LookML-Dateien von Grund auf neu erstellen können.

Legen Sie auf der Seite Neues Projekt die folgenden Optionen fest, um ein leeres Projekt zu erstellen:

  1. Project Name (Projektname): Geben Sie einen Namen für Ihr Projekt ein. Projektnamen sind groß- und kleinschreibungsempfindlich und dürfen keine Leerzeichen oder bestimmte Sonderzeichen enthalten. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als dauerhafte ID für das Projekt, da der Projektname in Looker auf folgende Weise verwendet wird:

    • Damit wird das Projekt für API-Aufrufe mit dem Parameter project_id identifiziert.
    • Damit wird das Projekt in der internen Datenbank der Looker-Instanz identifiziert.
    • Hiermit wird das Projekt für den lokalen Projektimport angegeben.
    • Das Projekt wird auf der Seite LookML-Projekte angezeigt.
    • Das Projekt wird im Bereich Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. In einer Looker-Instanz mit der URL example.looker.com befindet sich die Projektmanifestdatei für das Projekt ecommerce beispielsweise unter der URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  2. Ausgangspunkt: Wählen Sie Leeres Projekt aus.

Klicken Sie abschließend auf Projekt erstellen. Looker erstellt das Projekt und öffnet es in der Looker IDE.

Nächste Schritte

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