LookML-Dateien und -Ordner verwalten

LookML-Projektdateien werden im Bereich „Dateibrowser“ der Looker IDE in Ordnern organisiert. Diese Seite enthält Anweisungen zum Erstellen und Verwalten von Ordnern und Dateien in einem LookML-Projekt.

Informationen zur Struktur und zum Zweck der einzelnen Dateitypen in einem LookML-Projekt finden Sie auf der Dokumentationsseite Dateitypen in einem LookML-Projekt.

Bevor Sie beginnen: Wichtige Namenskonventionen für Dateien und Ordner

Beim Erstellen von Dateien und Ordnern sollten Sie die folgenden Namenskonventionen beachten:

  • Groß-/Kleinschreibung: LookML unterscheidet zwischen Groß- und Kleinschreibung. Achten Sie darauf, die Konventionen Ihres Projekts bei der Benennung Ihrer Ordner einzuhalten. Wenn Sie beispielsweise in Ihrem Projekt nur Kleinbuchstaben verwenden, sollten Sie den Ordner views statt Views nennen. Das ist besonders dann von Vorteil, wenn Sie den Dateipfad angeben müssen, z. B. wenn Sie Dateien einschließen. Im Allgemeinen ist es eine gute Idee, bei der Benennung von LookML-Objekten und -Ordnern einheitlich Kleinbuchstaben zu verwenden.
  • Leerzeichen und Sonderzeichen: Dateinamen dürfen keine Leerzeichen oder folgende Zeichen enthalten: / ? * : | " < > %
  • Dateiendungen: Wenn Sie LookML-Dateien mit der Looker IDE erstellen, fügt Looker automatisch die Erweiterung .lkml am Ende des Dateinamens hinzu, wenn Sie die Erweiterung nicht manuell einfügen. Wenn Sie beispielsweise den Dateinamen flights_data_tests eingeben, erhält die Datei von Looker den Namen flights_data_tests.lkml.
  • Angezeigten Namen eines LookML-Objekts ändern: Wenn Sie den angezeigten Namen eines Modells oder LookML-Objekts ändern möchten, können Sie den Parameter label oder den Parameter alias verwenden, anstatt die Datei oder das Objekt umzubenennen. Die Parameter label und alias ändern den angezeigten Namen, behalten aber die zugrunde liegende URL bei, die für E-Mails und andere Systeme verwendet wird. Im Allgemeinen sollten Sie Vorkehrungen treffen, um Modelländerungen so nicht invasiv wie möglich vorzunehmen. Wenn Sie ein Modell oder Objekt umbenennen müssen, verwenden Sie den Content Validator, um alle Verweise auf das Modell oder Objekt zu aktualisieren.

Ordner erstellen

Sie können Ordner für verschiedene Dateitypen erstellen, z. B. Ansichtsdateien oder Modelldateien. Sie können sogar Unterordner erstellen. Dies ist sehr nützlich, wenn Sie include nur einen Teil der Ansichten verwenden möchten.

So erstellen Sie einen Ordner:

  1. Wählen Sie im entsprechenden Menü die Option Create Folder (Ordner erstellen) aus:
    • Um einen neuen Ordner auf der obersten Ebene Ihrer Verzeichnisstruktur zu erstellen, verwenden Sie das Menü Datei oder Ordner hinzufügen. Um auf dieses Menü zuzugreifen, wählen Sie oben im Bereich Dateibrowser das Symbol + (Plus) aus.
    • Um unter einem vorhandenen Ordner einen neuen Unterordner zu erstellen, verwenden Sie das Dreipunkt-Menü Ordneroptionen des vorhandenen Ordners.
  2. Geben Sie einen Namen für den neuen Ordner ein.
  3. Wählen Sie Erstellen aus.

Der neue Ordner wird dem Navigationsbereich hinzugefügt.

Erstellen von Dateien

Wenn Sie ein neues Projekt erstellen, können Sie automatisch eine Modelldatei generieren und Dateien basierend auf Ihrer Datenbank ansehen. Für bestehende Projekte können Sie manuell neue Dateien erstellen.

So erstellen Sie eine neue Datei in Ihrem LookML-Projekt:

  1. Wählen Sie das entsprechende Menü aus:

    • Um eine neue Datei auf der obersten Ebene Ihrer Verzeichnisstruktur zu erstellen, verwenden Sie das Menü Datei oder Ordner hinzufügen. Wählen Sie dazu oben im Bereich Dateibrowser das + (Plus)-Symbol aus.
    • Um eine neue Datei in einem vorhandenen Ordner zu erstellen, verwenden Sie das Dreipunkt-Menü Ordneroptionen für den vorhandenen Ordner.

  2. Wählen Sie den Typ der LookML-Datei aus, die Sie erstellen möchten. Klicken Sie auf die Links in der folgenden Liste, um eine detailliertere Beschreibung der einzelnen Dateitypen zu erhalten. Sie können die folgenden Dateitypen erstellen:

  3. Geben Sie im Pop-up-Fenster Datei erstellen einen Namen für die neue Datei ein. Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien finden Sie unter Wichtige Hinweise zum Erstellen von Dateien und Ordnern.

  4. Wählen Sie Erstellen aus. Die neue Datei wird dort angezeigt, wo Sie sie erstellt haben. Bei Bedarf können Sie sie ganz einfach in einen anderen Ordner verschieben.

Überlegungen zum Erstellen von Ansichtsdateien

Die meisten LookML-Entwickler beginnen mit einer oder mehreren Ansichtsdateien, die automatisch erstellt werden, wenn das LookML-Projekt aus einer Reihe von Tabellen in einer Datenbank generiert wird. Zusätzlich zu den auf dieser Seite beschriebenen Methoden zum Erstellen leerer Ansichtsdateien und zum Hochladen von Dateien gibt es jedoch noch viele weitere Möglichkeiten, wie Looker-Entwickler im Entwicklungsmodus Ansichtsdateien zu einem LookML-Projekt hinzufügen können:

Wenn Sie eine neue Ansicht verwenden möchten, fügen Sie sie mithilfe des Parameters explore zu Ihrer Modelldatei hinzu oder verwenden Sie den Parameter join, um sie mit einem vorhandenen Explore in Ihrer Modelldatei zu verknüpfen.

Neue Ansicht aus einer vorhandenen Datenbanktabelle hinzufügen

Im Entwicklermodus können Sie eine Ansichtsdatei aus einer vorhandenen Datenbanktabelle erstellen.

  1. Wählen Sie in einem Projekt das Menü Datei oder Ordner hinzufügen aus, indem Sie in der Looker-IDE in der Liste der Projektdateien oben in der Liste der Projektdateien auf + (Plus) klicken. Alternativ können Sie das Menü eines Ordners auswählen, um die Datei im Ordner zu erstellen.

  2. Wählen Sie Ansicht aus Tabelle erstellen aus.

  3. Looker zeigt eine Liste der Tabellen an, die einer Ihrer Verbindungen zugeordnet sind. Sie können die Verbindung über das Drop-down-Menü Verbindung oben links ändern.

  4. Wählen Sie alle Tabellen aus, aus denen Sie Ansichten erstellen möchten, indem Sie das Kästchen links neben dem Tabellennamen anklicken. Sie können Datenbanken oder Schemas in dieser Liste minimieren oder maximieren, um auf alle verfügbaren Tabellen zuzugreifen.

  5. Scrollen Sie auf der Seite nach unten und wählen Sie Ansichten erstellen aus.

  6. Looker generiert Ansichten mit LookML für alle Tabellenspalten.

Dateien hochladen

Du kannst auch Dateien von deinem Computer in dein Projekt hochladen. Dies ist hilfreich, wenn Sie JSON-Datendateien oder LookML-Dateien lokal auf Ihrem Computer erstellt haben.

Verwenden Sie die Drag-and-drop-Funktion in der Looker-IDE, um eine Datei in Ihr Projekt hochzuladen:

  1. Gehen Sie zu Ihren Projektdateien.
  2. Ziehen Sie die Datei von Ihrem Computer in die Looker-IDE. Die Datei wird im Stammverzeichnis Ihrer Verzeichnisstruktur angezeigt.
  3. Nachdem die Datei hochgeladen wurde, verschieben Sie sie in einen anderen Ordner.

Dateien und Ordner löschen

Wenn Sie einen Ordner oder eine Datei löschen möchten, wählen Sie im linken Bereich der IDE im Dreipunkt-Menü Dateioptionen des Elements die Option Löschen aus.

Wenn Sie einen Ordner löschen, wird in der IDE ein Bestätigungs-Pop-up angezeigt. Im Pop-up-Fenster wird angegeben, wie viele Elemente gelöscht werden, einschließlich des Ordners und aller darin enthaltenen Dateien.

Mehrere Dateien und Ordner gleichzeitig löschen

So löschen Sie mehrere Ordner und Dateien gleichzeitig:

  1. Wählen Sie oben im Steuerfeld Dateibrowser das Symbol für die Bulk-Bearbeitung aus.

  2. Wählen Sie die Elemente aus, die Sie löschen möchten. Die Anzahl der ausgewählten Dateien wird neben der Überschrift Dateien auswählen angezeigt.

    • Um einzelne Dateien auszuwählen oder die Auswahl aufzuheben, erweitern Sie die Ordner der entsprechenden Dateien und klicken Sie das Kästchen neben den Dateinamen an.
    • Um ganze Ordner und deren Inhalte auszuwählen oder die Auswahl aufzuheben, aktivieren Sie das Kontrollkästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Abschnitt in der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt und klicken Sie dann auf den Bildschirm. Aktivieren Sie das Kontrollkästchen für das oberste Element im Bereich, halten Sie die Umschalttaste gedrückt und aktivieren Sie das Kontrollkästchen für das letzte Element in der Liste. Beide Elemente und alle dazwischen liegenden Elemente werden ausgewählt. Sie können auch einfach bei gedrückter Umschalttaste auf ein Element klicken, um das Element und alles darüber in der Verzeichnisliste auszuwählen.

  3. Wählen Sie das Papierkorbsymbol Elemente löschen aus. Die IDE zeigt dann ein Pop-up-Menü mit den ausgewählten Elementen an.

  4. Bestätigen Sie die zu löschenden Artikel, indem Sie Ja, löschen auswählen, oder kehren Sie zur Artikelauswahl zurück, indem Sie Abbrechen auswählen.

  5. Klicken Sie unter Dateien auswählen auf das X, um den Bulk-Bearbeitungsmodus zu beenden.

Elemente in ein Ordnerprojekt verschieben

Um Dateien zu verschieben, ziehen Sie die Datei oder einen Ordner per Drag-and-drop in einen anderen Ordner.

Der Zielordner muss nicht erweitert werden, um andere Ordner oder Dateien aufzunehmen. Ein Ordner wird automatisch erweitert, wenn Sie den Mauszeiger darauf bewegen.

Mehrere Dateien und Ordner gleichzeitig verschieben

So verschieben Sie mehrere Ordner und Dateien gleichzeitig:

  1. Wählen Sie oben im Steuerfeld Dateibrowser das Symbol für die Bulk-Bearbeitung aus.

  2. Wählen Sie die Elemente aus, die Sie verschieben möchten. Die Anzahl der ausgewählten Dateien wird neben der Überschrift Dateien auswählen angezeigt.

    • Um einzelne Dateien auszuwählen oder die Auswahl aufzuheben, erweitern Sie die Ordner der entsprechenden Dateien und klicken Sie das Kästchen neben den Dateinamen an.
    • Um ganze Ordner und deren Inhalte auszuwählen oder die Auswahl aufzuheben, aktivieren Sie das Kontrollkästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Abschnitt in der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt und klicken Sie dann auf den Bildschirm. Aktivieren Sie das Kontrollkästchen für das oberste Element im Bereich, halten Sie die Umschalttaste gedrückt und aktivieren Sie das Kontrollkästchen für das letzte Element in der Liste. Beide Elemente und alle dazwischen liegenden Elemente werden ausgewählt. Sie können auch einfach bei gedrückter Umschalttaste auf ein Element klicken, um das Element und alles darüber in der Verzeichnisliste auszuwählen.

  3. Wählen Sie das Ordnersymbol Elemente verschieben aus, um die Option auszuwählen. In der IDE wird dann ein Pop-up-Menü zur Ordnerauswahl angezeigt.

  4. Wählen Sie im Pop-up-Menü Verschieben nach einen Ordner für die ausgewählten Elemente aus oder wählen Sie Neuer Ordner aus, um einen neuen Ordner zu erstellen. Als Projektname wird oben auf der nächsten Menüseite der Dateipfad des Ordners angezeigt, den Sie ausgewählt haben. Wenn Sie Elemente in das Stammverzeichnis Ihres Projekts verschieben möchten, wählen Sie Verschieben aus, ohne einen Ordner auszuwählen.

  5. Bestätigen Sie das ausgewählte Ziel, indem Sie Verschieben auswählen, oder erstellen Sie einen neuen Ordner im ausgewählten Ordner, indem Sie Neuer Ordner auswählen, oder kehren Sie zum Optionsmenü des Hauptordners zurück, indem Sie den Link für den Projektnamen im Dateipfad auswählen.

  6. Klicken Sie unter Dateien auswählen auf das X, um den Bulk-Bearbeitungsmodus zu beenden.