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 in der Dokumentation zu LookML-Projekten und dem Entwicklungsmodell sowie zu LookML-Begriffen und -Konzepten. Informationen zum Zugriff auf vorhandene Projekte und zum Bearbeiten dieser Projekte finden Sie auf der Dokumentationsseite Auf Projektinformationen zugreifen und diese bearbeiten.

Ein LookML-Projekt kann mehr als eine Modelldatei enthalten. Wenn Sie jedoch Berechtigungen für Nutzer zum Anzeigen und Bearbeiten von LookML für eine bestimmte Modelldatei festlegen möchten, sollten Sie ein neues Projekt erstellen. Die meisten Berechtigungen in Looker gelten auf Modellebene. Es gibt jedoch einige Berechtigungen, die auf Projektebene gelten, darunter see_lookml, mit der Sie 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 im Abschnitt 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 festzulegen.

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

Looker kann ein Projekt auf verschiedene Arten erstellen. Die Schritte hängen von der Option Ausgangspunkt ab, die Sie auf der Seite Neues Projekt auswählen. In den folgenden Abschnitten wird beschrieben, wie diese Startpunkte funktionieren:

Modell automatisch aus Ihrer Datenbank generieren

Geben Sie auf der Seite New Project (Neues Projekt) die folgenden Optionen an, um automatisch ein Modell aus einer Datenbank zu generieren.

  1. Projektname: Geben Sie Ihrem Projekt einen Namen. 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, da Looker den Projektnamen auf folgende Weise verwendet:

    • Zum Identifizieren des Projekts für API-Aufrufe, die den Parameter project_id enthalten.
    • Zur Identifizierung des Projekts in der internen Datenbank der Looker-Instanz.
    • Zum Identifizieren des Projekts für den lokalen Projektimport.
    • Um das Projekt auf der Seite LookML-Projekte anzuzeigen.
    • Das Projekt wird im Abschnitt Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. In einer Looker-Instanz mit der URL example.looker.com finden Sie 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 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 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 Sie Tabellenpräfixe aus den Namen der Ansichtsdateien 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 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.

Klicken Sie abschließend auf Projekt erstellen, um ein Projekt zu erstellen, das das generierte Modell enthält.

  • 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 bei BigQuery-Verbindungen ein LookML-Projekt aus Ihrer Datenbank generieren, füllt Looker Feldbeschreibungen automatisch mit den Beschreibungen aus Ihren BigQuery-Spaltenmetadaten, sofern vorhanden.

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

Öffentliches Git-Repository von der Seite Neues Projekt klonen

Wenn Sie auf der Seite Neues Projekt die Option Öffentliches Git-Repository klonen als Ausgangspunkt auswählen, kopiert Looker die Dateien aus einem öffentlichen Git-Repository in ein neues LookML-Projekt.

Looker unterstützt das Klonen eines öffentlichen Git-Repositorys mithilfe der HTTPS-Web-URL des Repositorys.

So klonen Sie ein vorhandenes öffentliches Git-Repository in ein Looker-Projekt:

  1. Prüfen Sie, ob Sie sich im Entwicklungsmodus befinden.
  2. Wählen Sie im Looker-Navigationsbereich im Abschnitt Entwickeln die Option Projekte aus.

  3. Führen Sie auf der Seite LookML-Projekte je nach Konfiguration Ihrer Instanz einen der folgenden Schritte aus:

    • Klicken Sie auf den Button Neues LookML-Projekt, um die Seite Neues Projekt zu öffnen.
    • Klicken Sie auf den Button Neues Modell, um die Seite Modell erstellen zu öffnen. Klicken Sie dann im Informationsbanner auf der Seite Modell erstellen auf den Link Hier klicken, um die Seite Neues Projekt zu öffnen.

  4. Geben Sie im Feld Projektname einen Namen für Ihr Projekt ein. Bei Projektnamen wird zwischen Groß- und Kleinschreibung unterschieden. Sie dürfen keine Leerzeichen oder bestimmte Sonderzeichen enthalten. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als permanente ID für das Projekt, da Looker den Projektnamen auf folgende Weise verwendet:

    • Zum Identifizieren des Projekts für API-Aufrufe, die den Parameter project_id enthalten.
    • Zur Identifizierung des Projekts in der internen Datenbank der Looker-Instanz.
    • Zum Identifizieren des Projekts für den lokalen Projektimport.
    • Um das Projekt auf der Seite LookML-Projekte anzuzeigen.
    • Das Projekt wird im Abschnitt Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. Beispiel: Auf einer Looker-Instanz mit der URL example.looker.com finden Sie die Projektmanifestdatei für das Projekt ecommerce unter der URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Wählen Sie für das Feld Startpunkt die Option Öffentliches Git-Repository klonen aus.

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

  7. Klicken Sie auf Projekt erstellen. Looker klont das Repository und öffnet die Looker-IDE für das neue LookML-Projekt mit den Projektdateien aus dem geklonten Repository.

Nachdem Looker Ihr neues LookML-Projekt erstellt hat, müssen Sie die Git-Versionsverwaltung einrichten, indem Sie eine Verbindung zu einem Git-Repository herstellen. Informationen zum Herstellen einer Verbindung zu Git über HTTPS oder SSH finden Sie auf der Dokumentationsseite „Git-Verbindung einrichten und testen“.

Je nach Situation möchten Sie Ihre Git-Verbindung möglicherweise so einrichten, dass Änderungen an Ihr eigenes Git-Repository übertragen werden, oder Sie möchten Änderungen an das ursprüngliche, geklonte Git-Repository übertragen:

  • Wenn Sie die geklonten Dateien als Ausgangspunkt für Ihr eigenes Projekt unabhängig vom öffentlichen Git-Repository verwenden möchten, richten Sie die Git-Verbindung Ihres Projekts so ein, dass sie auf Ihr eigenes Git-Repository verweist, und übertragen Sie Ihre Änderungen dorthin.
  • Wenn Sie Updates an das öffentliche Git-Repository zurückgeben möchten, das Sie geklont haben, und Sie ein persönliches Zugriffstoken mit Lese-/Schreibzugriff auf das öffentliche Repository haben, richten Sie die Git-Verbindung Ihres Projekts so ein, dass sie auf das öffentliche Git-Repository verweist, und übertragen Sie Ihre Änderungen dorthin.

Nachdem Sie die Git-Verbindung zu einem Repository eingerichtet haben, können Sie die Dateien in der Looker-IDE bearbeiten und dann wie bei jedem Standard-LookML-Projekt die Versionsverwaltung verwenden und Änderungen in der Produktion bereitstellen.

Alternative Methode zum Klonen eines öffentlichen Git-Repositorys

Am einfachsten klonen Sie ein öffentliches Git-Repository, indem Sie in Looker die Seite Neues Projekt verwenden.

Alternativ können Sie das Repository forken und mit einem leeren Projekt in Looker verbinden. Gehen Sie dazu so vor:

  1. Rufen Sie Ihren Git-Anbieter auf und erstellen Sie einen Fork des Repositorys.
  2. Erstellen Sie in Looker ein leeres Projekt, wie im Abschnitt Leeres Projekt erstellen auf dieser Seite beschrieben.
  3. Nachdem Sie das neue leere LookML-Projekt erstellt haben, richten Sie die Git-Verbindung des Projekts zu Ihrem Git-Repository-Fork entweder über HTTPS oder SSH ein.

Nachdem Sie die Git-Verbindung zu Ihrem Repository-Fork eingerichtet haben, können Sie die Dateien in der Looker-IDE bearbeiten und dann wie bei jedem Standard-LookML-Projekt die Versionsverwaltung verwenden und Änderungen in der Produktion bereitstellen.

Leeres Projekt erstellen

Wenn Sie auf der Seite Neues Projekt die Option Leeres Projekt als Ausgangspunkt auswählen, erstellt Looker ein leeres Projekt, sodass Sie Ihre LookML-Dateien von Grund auf neu erstellen können.

So erstellen Sie ein leeres Projekt:

  1. Prüfen Sie, ob Sie sich im Entwicklungsmodus befinden.
  2. Wählen Sie im Looker-Navigationsbereich im Abschnitt Entwickeln die Option Projekte aus.

  3. Führen Sie auf der Seite LookML-Projekte je nach Konfiguration Ihrer Instanz einen der folgenden Schritte aus:

    • Klicken Sie auf den Button Neues LookML-Projekt, um die Seite Neues Projekt zu öffnen.
    • Klicken Sie auf den Button Neues Modell, um die Seite Modell erstellen zu öffnen. Klicken Sie dann im Informationsbanner auf der Seite Modell erstellen auf den Link Hier klicken, um die Seite Neues Projekt zu öffnen.

  4. Geben Sie im Feld Projektname einen Namen für Ihr Projekt ein. Bei Projektnamen wird zwischen Groß- und Kleinschreibung unterschieden. Leerzeichen und bestimmte Sonderzeichen sind nicht zulässig. Wählen Sie den Projektnamen sorgfältig aus und betrachten Sie ihn als permanente ID für das Projekt, da Looker den Projektnamen auf folgende Weise verwendet:

    • Zum Identifizieren des Projekts für API-Aufrufe, die den Parameter project_id enthalten.
    • Zur Identifizierung des Projekts in der internen Datenbank der Looker-Instanz.
    • Zum Identifizieren des Projekts für den lokalen Projektimport.
    • Um das Projekt auf der Seite LookML-Projekte anzuzeigen.
    • Das Projekt wird im Abschnitt Entwickeln des Looker-Navigationsbereichs angezeigt.
    • Als Teil der URL für Projektdateien. In einer Looker-Instanz mit der URL example.looker.com finden Sie die Projektmanifestdatei für das Projekt ecommerce beispielsweise unter der URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Wählen Sie für das Feld Ausgangspunkt die Option Leeres Projekt aus.

  6. Klicken Sie auf Projekt erstellen. Looker erstellt das Projekt und öffnet es in der Looker-IDE.

Fehler „Projekt ist bereits vorhanden“ beheben

Wenn Sie ein neues Projekt in der Looker-IDE erstellen, wird möglicherweise der Fehler Project already exists angezeigt, auch wenn das Projekt in der Looker-Benutzeroberfläche nicht sichtbar ist (auch nicht für Nutzer mit Administratorberechtigungen). Dieses Problem tritt auf, wenn ein Nutzer zuvor im Entwicklungsmodus ein Projekt mit demselben Namen erstellt, aber kein Modell bereitgestellt oder die Änderungen nicht in die Produktion übertragen hat. In Looker ist ein Projekt in diesem nicht-committeten Zustand nur für den Benutzer sichtbar, der es erstellt hat.

Um dieses Problem zu beheben, müssen Sie den Ersteller des Projekts identifizieren und als dieser Nutzer das Projekt wie folgt committen und bereitstellen oder löschen. Sie müssen Looker-Administrator sein oder die Berechtigung sudo haben, um als Projektersteller zu agieren.

1. Projektersteller identifizieren: Führen Sie eine Abfrage in den Systemaktivitäts-Explores mit dem Projektnamen aus, um den Nutzer zu identifizieren, der das Projekt ursprünglich erstellt hat. 1. Sudo als Ersteller: Verwenden Sie die Looker-Funktion Sudo, um die Identität des identifizierten Nutzers anzunehmen. 1. Projekt verwalten oder löschen: Melden Sie sich als Ersteller an und wechseln Sie in den Entwicklungsmodus. Das Projekt ist jetzt in der IDE sichtbar. Sie können das Projekt konfigurieren oder bereitstellen oder das Projekt löschen, um den Projektnamen freizugeben.

Nächste Schritte

Nachdem ein Projekt erstellt wurde, können Sie Folgendes tun: