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 zu LookML-Projekten und -Entwicklungsmodell und LookML-Begriffen und -Konzepten. Informationen zum Zugreifen auf und Bearbeiten vorhandener Projekte finden Sie auf der Dokumentationsseite Projektinformationen aufrufen und bearbeiten.

Ein LookML-Projekt kann mehrere Modelldateien enthalten. Wenn Sie jedoch Berechtigungen für Benutzer zum Ansehen und Bearbeiten von LookML-Codes für eine bestimmte Modelldatei festlegen möchten, sollten Sie ein neues Projekt erstellen. Die meisten Berechtigungen in Looker gelten zwar auf Modellebene, aber einige gelten auch auf Projektebene, z. B. see_lookml, mit dem Sie LookML für ein Projekt ansehen können, und develop, mit dem Sie die LookML bearbeiten können. Wenn Sie Nutzern Zugriff auf ein Modell gewähren möchten, aber nicht auf ein anderes, empfiehlt es sich, ein separates Projekt mit dem Modell zu erstellen, auf das sie keinen Zugriff haben sollen.

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

Projekt erstellen

So erstellen Sie ein Projekt:

  1. Vergewissern Sie sich, dass Sie sich im Entwicklungsmodus befinden.

  2. Wählen Sie im Abschnitt Develop des Navigationsbereichs 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 Projektnamens und des Startpunkts. Es gibt mehrere Möglichkeiten, ein Projekt in Looker zu erstellen. Die erforderlichen Schritte hängen von der Option Ausgangspunkt ab, die Sie auf der Seite Neues Projekt ausgewählt haben. In den folgenden Abschnitten wird die Funktionsweise dieser Ausgangspunkte beschrieben:

Modell automatisch aus Ihrer Datenbank generieren

Wenn Sie Generate Model from Database Schema (Modell aus Datenbankschema generieren) als Ausgangspunkt auswählen, erstellt der LookML-Generator automatisch Ihr Modell und zeigt die Projektdateien anhand der Tabellen in Ihrer Datenbank an. Weitere Informationen finden Sie auf der Dokumentationsseite Modell generieren.

Bei dieser Option fragt Looker nach dem Verbindungsnamen, damit LookML automatisch anhand Ihrer Datenbank generiert werden kann. Sie können jedoch später weitere Verbindungen hinzufügen.

Ö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 haben jedoch die Möglichkeit, das schreibgeschützte Projekt in ein anderes Looker-Projekt zu importieren, wo Sie dann die Dateien bearbeiten können. Darüber hinaus können Sie die geklonten Repository-Dateien als Ausgangspunkt verwenden und dann den Looker-Parameter extends oder Optimierungen verwenden, um daraus ein Projekt zu erstellen.

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

  1. Vergewissern Sie sich, dass Sie sich im Entwicklungsmodus befinden.
  2. Wählen Sie im Menü Develop (Entwickeln) die Option Manage LookML Projects (LookML-Projekte verwalten) aus.

  3. Wählen Sie auf der Seite LookML-Projekte die Option Neues LookML-Projekt aus, um die Seite Neues Projekt zu öffnen.

  4. Legen Sie auf der Seite Neues Projekt die Optionen für Ihr Projekt fest:

    • 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 Öffentliches Git-Repository klonen aus.

    • 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 in das richtige Format ändern, indem Sie „https://“ ersetzen mit „git://“ und dann „.git“ hinzufügen, am Ende. Die URL, die Sie eingeben, wäre git://github.com/llooker/blocks_redshift_admin.git.

  5. Wählen Sie Projekt erstellen aus. Looker ruft alle Dateien des öffentlichen Repositorys 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, sodass Sie Ihre LookML-Dateien von Grund auf neu erstellen können.

So erstellen Sie ein leeres Projekt:

  1. Vergewissern Sie sich, dass Sie sich im Entwicklungsmodus befinden.
  2. Wählen Sie im Menü Develop (Entwickeln) die Option Manage LookML Projects (LookML-Projekte verwalten) aus.

  3. Wählen Sie auf der Seite LookML-Projekte die Option Neues LookML-Projekt aus, um die Seite Neues Projekt zu öffnen.

  4. Legen Sie auf der Seite Neues Projekt die Optionen für Ihr Projekt fest:

    • 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 Leeres Projekt aus.

  5. Wählen Sie Projekt erstellen aus. Looker erstellt das Projekt und öffnet es in der Looker-IDE.

Wenn Sie ein leeres Projekt haben, können Sie Modell- und Ansichtsdateien erstellen und dann Ihr Projekt mit Git verbinden, um Änderungen an Ihren LookML-Dateien aufzuzeichnen und Versionen Ihrer Dateien zu verwalten.

Modell konfigurieren

Über die Schaltfläche Neues Modell konfigurieren oben auf der Seite LookML-Projekte können Sie eine Konfiguration für ein vorhandenes oder ein geplantes Modell hinzufügen.

Das Konfigurieren eines Modells für ein Projekt, das noch nicht vorhanden ist, ist nützlich, wenn die Entwickler nicht die Berechtigung manage_models oder manage_project_models erhalten haben, wie auf der Dokumentationsseite Modell generieren beschrieben. Wenn Sie das Modell für die Entwickler konfigurieren, können diese Abfragen ausführen, sobald die Modelldatei generiert oder erstellt wird. Weitere Informationen zu Projekten, die nur eine Konfiguration haben, finden Sie auf der Dokumentationsseite Projektinformationen aufrufen und bearbeiten.

Sie können auch angeben, welche Datenbankverbindungen vom Modell verwendet werden können, oder festlegen, dass das Modell alle aktuellen oder zukünftigen Verbindungen verwenden darf. Looker-Entwickler verwenden den LookML-Parameter connection, um in der Modelldatei anzugeben, welche Verbindung das Modell verwenden soll. Wenn ein Entwickler eine Verbindung angibt, die Sie in der Konfiguration des Modells nicht zugelassen haben, wird keine Abfrage für dieses Modell ausgeführt.