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 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 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 einige auch auf Projektebene, z. B. see_lookml, mit dem Sie LookML-Code 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, sollten Sie ein separates Projekt mit dem Modell 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 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.

Dadurch wird die Seite Neues Projekt geöffnet, auf der Sie Einstellungen für Ihr Projekt festlegen können, z. B. den Projektnamen und den Startpunkt.

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 die Funktionsweise dieser Ausgangspunkte beschrieben:

Modell automatisch aus Ihrer Datenbank generieren

Wenn Sie Modell aus Datenbankschema generieren als Ausgangspunkt auswählen, erstellt der LookML-Generator automatisch Ihr Modell und die Projektdateien für die Ansichten anhand der Tabellen in Ihrer Datenbank. Weitere Informationen finden Sie auf der Seite Modell generieren.

Bei dieser Option fragt Looker nach dem Verbindungsnamen, damit automatisch LookML-Code basierend auf 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 können das schreibgeschützte Projekt jedoch in ein anderes Looker-Projekt importieren, in dem Sie die Dateien dann 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:

    • Project Name (Projektname): Geben Sie einen Namen für Ihr Projekt ein. 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.
      • Hiermit wird das Projekt für den lokalen Projektimport angegeben.
      • So zeigen Sie das Projekt auf der Seite LookML-Projekte an.
      • 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.
    • 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ürden, wäre git://github.com/llooker/blocks_redshift_admin.git.

  5. Wählen Sie Projekt erstellen aus. 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, 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 Menü Entwickeln die Option 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:

    • Project Name (Projektname): Geben Sie einen Namen für Ihr Projekt ein. 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. 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.
    • 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

Klicken Sie oben auf der Seite LookML-Projekte auf die Schaltfläche Neues Modell konfigurieren, um eine Konfiguration für ein vorhandenes oder geplantes Modell hinzuzufügen.

Das Konfigurieren eines Modells für ein noch nicht vorhandenes Projekt ist nützlich, wenn die Entwickler weder die Berechtigung manage_models noch die Berechtigung manage_project_models haben, wie auf der Dokumentationsseite Modell generieren beschrieben. Wenn Sie das Modell für die Entwickler konfigurieren, können sie Abfragen ausführen, sobald sie die Modelldatei generiert oder erstellt haben. Weitere Informationen zu Projekten mit nur einer Konfiguration finden Sie auf der Dokumentationsseite Auf Projektinformationen zugreifen und sie 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.