Auf Projektinformationen zugreifen und sie bearbeiten

Auf der Seite LookML-Projekte wird eine Liste aller LookML-Projekte in der Looker-Instanz sowie aller Modelle in den einzelnen Projekten angezeigt.

So rufen Sie die Seite LookML-Projekte auf:

  1. Öffnen Sie den Bereich Entwickeln, indem Sie im Navigationsbereich die Option Entwickeln auswählen.
  2. Wählen Sie im Bereich Entwickeln die Option Projekte aus.

Projekte erstellen

Auf dieser Dokumentationsseite wird davon ausgegangen, dass Sie bereits ein Projekt mit einer der folgenden Methoden erstellt haben:

Vorhandene Projekte und ihre Modelle ansehen

Eine Liste der vorhandenen Projekte finden Sie auf der Seite LookML-Projekte.

Im Produktionsmodus werden auf der Seite LookML-Projekte Projekte aufgeführt, die generiert und in die Produktion übertragen wurden. Im Entwicklungsmodus werden auf der Seite Projekte aufgeführt, die Sie aus der Produktion abgerufen oder selbst im Entwicklungsmodus generiert haben. Die Seite LookML-Projekte enthält die folgenden grundlegenden Kategorien:

Informationen zum Angeben eines neuen Projekts oder eines neuen Modells für ein vorhandenes Projekt finden Sie auf der Dokumentationsseite Modell generieren.

Eintrag für ein Projekt aufrufen

Auf der Seite LookML-Projekte werden für jedes Projekt die folgenden Elemente angezeigt:

  • Spalte Projekt: Der Name des Projekts. Für jedes Projekt können ein oder mehrere Modelle aufgeführt sein. Wählen Sie den Projektnamen aus, um zur LookML für dieses Projekt zu gelangen.
  • Spalte Modelle: Die LookML-Modelldateien für das angegebene Projekt. Wenn sich Ihre Entwicklungsumgebung von der Produktionsumgebung unterscheidet, kann sich diese Liste zwischen Entwicklungs- und Produktionsmodus ändern. Möglicherweise haben Sie beispielsweise ein neues Modell im Entwicklungsmodus erstellt, das Sie noch nicht in die Produktion übertragen haben.
  • Spalte „Konfigurationsprobleme“: Wenn ein Problem mit einem Modell vorliegt, wird für das Modell ein Status angezeigt, der auf das Problem mit der Konfiguration hinweist.
  • Schaltfläche Konfigurieren: Wenn die Schaltfläche Konfigurieren für ein Projekt verfügbar ist, können Sie die Modellkonfiguration für dieses Projekt hinzufügen oder bearbeiten.

Wenn ein Problem mit einem Modell vorliegt, wird für das Modell ein Status angezeigt, der auf das Problem mit der Konfiguration hinweist.

Problem Erklärung
Die LookML-Modelldatei ist noch nicht vorhanden Dieses Problem tritt auf, wenn jemand ein Modell auf dieser Seite konfiguriert, aber noch keine entsprechende LookML-Datei dafür erstellt hat.
Konfiguration zur Verwendung erforderlich Dieses Problem tritt auf, wenn jemand eine neue LookML-Modelldatei in einem vorhandenen Projekt erstellt, sie aber noch nicht auf dieser Seite konfiguriert hat.
Die Verbindung „x“ ist nicht vorhanden Die in der Modelldatei deklarierte connection ist nicht vorhanden (z. B. wenn jemand sie falsch geschrieben oder noch nicht erstellt hat).
Das Modell „x“ hat nicht die Berechtigung für die Verbindung „y“ Die in der Modelldatei deklarierte connection ist gemäß der Konfiguration auf dieser Seite nicht zulässig.
Ein Modell mit dem Namen „x“ ist im Projekt „y“ bereits konfiguriert Modellnamen müssen in Ihrer Looker-Instanz eindeutig sein, auch wenn sie sich in verschiedenen Projekten befinden.

Eintrag für ein Marketplace-Projekt ansehen

Im Bereich Marketplace-Projekte auf der Seite LookML-Projekte werden Projekte aufgeführt, die während der Installation einer Marketplace-Anwendung, eines Blocks oder eines Plug-ins erstellt wurden. Das Angebot für jedes Marketplace-Projekt enthält die folgenden Elemente:

  • Eintrag: Ein Link zum Eintrag für die Anwendung, den Block oder das Plug-in im Looker Marketplace.
  • Projekt: Der Name des Projekts. Sie können auf den Namen des Projekts klicken, um das LookML aufzurufen oder zu bearbeiten.
  • Schaltfläche LookML ansehen oder LookML bearbeiten: Sie können zu einem Marketplace-Projekt navigieren, indem Sie für das schreibgeschützte Kernprojekt eines Marketplace-Blocks die Schaltfläche LookML ansehen oder für das Konfigurationsprojekt die Schaltfläche LookML bearbeiten auswählen. Das Konfigurationsprojekt kann angepasst werden. Weitere Informationen zum Anpassen von Marketplace-Blöcken finden Sie auf der Dokumentationsseite Looker Marketplace-Blöcke anpassen.
  • Modelle: Die Gruppe von LookML-Modelldateien für das angegebene Projekt.
  • Schaltfläche Konfigurieren: Wenn neben dem Projekteintrag die Schaltfläche Konfigurieren verfügbar ist, können Sie die Modellkonfiguration des Projekts hinzufügen oder bearbeiten.

Eintrag für ein ausstehendes Projekt aufrufen

Der Bereich Ausstehende Projekte enthält Projekte und Modelle, die konfiguriert wurden, für die aber noch keine LookML generiert oder manuell definiert wurde.

Das Konfigurieren von Modellen, bevor das Projekt vorhanden ist, ist nützlich, wenn Sie Entwickler haben, die nicht die Berechtigung manage_models oder manage_project_models haben. Da das Modell bereits konfiguriert wurde, können diese Entwickler Abfragen ausführen, sobald sie das Projekt und das Modell erstellt haben. Wenn das Projekt generiert wird, wird der Eintrag für dieses Projekt in den oberen Bereich der Seite LookML-Projekte verschoben.

Der Abschnitt Ausstehende Projekte enthält die folgenden Elemente:

  • Spalte Projekt: In diesem Bereich werden Projekte aufgeführt, die konfiguriert, aber noch nicht generiert wurden. Der Projektname in diesem Feld ist der beabsichtigte Name des Projekts. Wählen Sie den Projektnamen aus, um die Seite Neues Projekt aufzurufen, auf der Sie das Projekt generieren können. Sie müssen sich im Entwicklungsmodus befinden, um die Seite Neues Projekt aufrufen zu können.
  • Spalte Modelle: Der Modellname, der beim Erstellen der Modellkonfiguration angegeben wurde.
  • Spalte „Zulässige Verbindungen“: In der Spalte rechts neben dem Modellnamen werden die Verbindungen angezeigt, die für dieses Modell zulässig waren, als die Modellkonfiguration erstellt wurde.
  • Schaltfläche Konfigurieren: Mit der Schaltfläche Konfiguration können Sie den Projektnamen und die für dieses Modell zulässigen Verbindungen ändern.
  • Schaltfläche LookML hinzufügen: Über die Schaltfläche LookML hinzufügen wird die Seite Neues Projekt für das Projekt geöffnet. Dort können Sie automatisch LookML generieren lassen, die auf einer Reihe von Tabellen in Ihrer Datenbank basiert.

Modellkonfigurationen hinzufügen und bearbeiten

Wenn neben dem Eintrag eines vorhandenen Projekts die Schaltfläche Konfigurieren verfügbar ist, können Sie die Modellkonfiguration des Projekts hinzufügen oder bearbeiten.

Wenn das Modell keine Konfiguration hat, wird beim Klicken auf Konfigurieren das Fenster Modell konfigurieren angezeigt. Im Fenster Modell konfigurieren können Sie den Modellnamen, den Projektnamen und die Verbindungen angeben, die für das Modell verfügbar sind.

Die Liste der Verbindungen enthält nur Verbindungen, die mit dem Projekt des Modells verwendet werden können. Verbindungen, die für die Verwendung in allen Projekten konfiguriert sind, haben das Label (Instance wide).

Sie können auch oben auf der Seite Projekte auf die Schaltfläche Neues Modell konfigurieren klicken, um das Fenster Modell konfigurieren zu öffnen. In diesem Fall können Sie das Fenster Modell konfigurieren verwenden, um ein neues Modell zu erstellen und zu konfigurieren. Das neue Modell enthält kein LookML, ist aber mit einer Verbindung verknüpft. Geben Sie dazu im Feld Modell einen neuen Namen für das Modell ein, füllen Sie das Feld Projekt mit einem neuen Namen aus oder wählen Sie denselben Namen wie für das Modell aus, wählen Sie die Verbindungen aus und klicken Sie auf Speichern. Später können Sie oder ein anderer Looker-Entwickler dem neuen Projekt LookML hinzufügen, um das Modell zu definieren.

Wenn das Modell eine Konfiguration hat, wird beim Klicken auf Konfigurieren das Fenster Modellkonfiguration bearbeiten angezeigt. Im Fenster Modellkonfiguration bearbeiten können Sie die für das Modell verfügbaren Verbindungen ändern.

Wenn Sie die Konfiguration für ein Modell bearbeiten, können Sie den Modellnamen sehen, aber nicht umbenennen. Modelle werden nach den Dateinamen benannt, die Sie beim Bearbeiten der Modelldateien in der Looker-IDE verwenden.

Im Feld Projekt können Sie angeben, dass das Modell einem anderen Projekt zugeordnet werden soll. Wenn Sie beispielsweise ein neues Projekt mit einem Modell mit demselben Namen erstellt haben, können Sie die Modellkonfiguration so umstellen, dass sie dem Modell des neuen Projekts zugeordnet wird.

Im Feld Zulässige Verbindungen können Sie das Modell auf eine Liste bestimmter Verbindungen beschränken oder dem Modell erlauben, jede Verbindung (alle aktuellen und zukünftigen Verbindungen) zu verwenden.

Projekt umbenennen

Wenn ein Looker-Administrator ein LookML-Projekt erstellt, gibt er einen Projektnamen an. Der Projektname sollte als permanente ID für das Projekt betrachtet werden, da er in Looker auf folgende Weise verwendet wird:

  • Zum Identifizieren des Projekts für API-Aufrufe mit project_id als Parameter.
  • Damit wird das Projekt in der internen Datenbank der Looker-Instanz identifiziert.
  • Zum Identifizieren des Projekts für den lokalen Projektimport.
  • Das Projekt wird auf der Seite LookML-Projekte angezeigt.
  • Wenn Sie das Projekt im Abschnitt Entwickeln des Looker-Navigationsbereichs anzeigen möchten.
  • 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 mit dem Namen ecommerce beispielsweise unter der folgenden URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

Wenn Sie die Looker-Berechtigung manage_models haben, können Sie den Namen eines LookML-Projekts auf der Seite Projektkonfiguration des Projekts ändern. Looker-Entwickler, die keine Administratoren sind, können die Seite Projektkonfiguration aufrufen, aber die Optionen auf der Seite nicht ändern.

So benennen Sie ein Projekt um:

  1. Prüfen Sie, ob der Entwicklermodus aktiviert ist.
  2. Rufen Sie Ihr Projekt in der Looker-IDE auf.
  3. Klicken Sie in Ihrem Projekt in der IDE-Navigationsleiste auf Einstellungen , um den Bereich mit den Projekteinstellungen zu öffnen.
  4. Wählen Sie im Bereich „Projekteinstellungen“ die Option Konfiguration aus.
  5. Verwenden Sie das Feld Name unter Projektkonfiguration, um den Namen Ihres Projekts zu bearbeiten.
  6. Klicken Sie auf der Seite Projektkonfiguration auf Projektkonfiguration speichern, um den neuen Projektnamen zu speichern.

Ein Projekt löschen

Wenn Sie Looker-Administrator sind, können Sie ein vorhandenes Projekt über die Projekteinstellungen des Projekts löschen. Öffnen Sie Ihr Projekt und klicken Sie in der IDE-Navigationsleiste auf Einstellungen , um die Projekteinstellungen aufzurufen.

Ein gelöschtes Projekt wird nicht mehr im Bereich Projekte auf der Seite LookML-Projekte angezeigt, aber weiterhin im Bereich Konfigurierte Projekte.

So entfernen Sie die Projektkonfiguration und damit das Projekt vollständig aus Ihrer Entwicklungsumgebung:

  1. Rufen Sie Ihr Projekt in der Looker-IDE auf.
  2. Klicken Sie in Ihrem Projekt in der IDE-Navigationsleiste auf Einstellungen , um den Bereich mit den Projekteinstellungen zu öffnen.
  3. Wählen Sie im Bereich „Projekteinstellungen“ die Option Konfiguration aus, um die Projektkonfiguration aufzurufen.
  4. Wählen Sie unter Projektkonfiguration die Option Projekt löschen aus.
  5. Prüfen Sie im Fenster Projekt löschen die Warnungen und die nicht synchronisierten Änderungen, die verloren gehen, wenn das Projekt gelöscht wird.
  6. Wenn Sie sicher sind, dass das Projekt gelöscht werden soll, geben Sie den Namen des Projekts in das Feld ein. Wenn Sie den Vorgang abbrechen und zu Ihrem Projekt zurückkehren möchten, verwenden Sie die Schaltfläche Zurück Ihres Browsers.
  7. Klicken Sie auf die Schaltfläche <Projektname> endgültig löschen.