LookML-Dateien und -Ordner verwalten

LookML-Projektdateien sind im Dateibrowser im Bereich der Looker-IDE in Ordnern organisiert. Diese Seite enthält eine Anleitung 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 Seite Dateitypen in einem LookML-Projekt.

Vorbereitung: Wichtige Namenskonventionen für Dateien und Ordner

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

  • Groß-/Kleinschreibung beachten:LookML berücksichtigt die Groß- und Kleinschreibung. Halten Sie sich beim Benennen der Ordner an die Konventionen Ihres Projekts. Wenn in Ihrem Projekt beispielsweise nur Kleinbuchstaben verwendet werden, sollten Sie den Ordner mit views und nicht Views benennen. Dies ist besonders dann wichtig, wenn Sie den Pfad einer Datei angeben müssen, z. B. wenn Sie Dateien einschließen. Es empfiehlt sich, bei der Benennung von LookML-Objekten und -Ordnern immer Kleinbuchstaben zu verwenden.
  • Leerzeichen und Sonderzeichen: Dateinamen dürfen keine Leerzeichen oder folgende Zeichen enthalten: / ? * : | " < > %
  • Dateierweiterungen: Beim Erstellen von LookML-Dateien mit der Looker-IDE 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, wird in Looker die Datei flights_data_tests.lkml benannt.
  • 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, verwenden dabei aber die zugrunde liegende URL, die für E-Mails oder andere Systeme verwendet wird. Im Allgemeinen sollten Sie Vorsichtsmaßnahmen ergreifen, um Modelländerungen so invasiv wie möglich zu gestalten. Wenn Sie ein Modell oder ein Objekt umbenennen möchten, 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. Dateien ansehen oder Modelldateien. Sie haben auch die Möglichkeit, Unterordner zu erstellen, was sehr nützlich ist, wenn Sie includeeinige Ihrer Ansichten auf einmal stellen möchten.

So erstellen Sie einen Ordner:

  1. Wählen Sie im entsprechenden Menü die Option Create Folder (Ordner erstellen) aus:
    • Wenn Sie einen neuen Ordner auf der obersten Ebene der Verzeichnisstruktur erstellen möchten, verwenden Sie das Menü Datei oder Ordner hinzufügen. Klicken Sie dazu oben im Bereich Dateibrowser auf das Pluszeichen (+).
    • Wenn Sie einen neuen Unterordner in einem vorhandenen Ordner erstellen möchten, verwenden Sie das Dreipunkt-Menü Ordneroptionen für den vorhandenen Ordner.
  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

Beim Erstellen eines neuen Projekts können Sie automatisch eine Modelldatei generieren und Dateien auf Grundlage Ihrer Datenbank ansehen. Bei vorhandenen Projekten können Sie neue Dateien manuell erstellen.

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

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

    • Wenn Sie eine neue Datei auf oberster Ebene Ihrer Verzeichnisstruktur erstellen möchten, verwenden Sie das Menü Datei oder Ordner hinzufügen. Klicken Sie dazu oben im Bereich Dateibrowser auf das Pluszeichen (+).
    • Wenn Sie eine neue Datei in einem vorhandenen Ordner erstellen möchten, 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 ausführlichere 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. In den wichtigen Hinweisen zum Erstellen von Dateien und Ordnern finden Sie Informationen zu Einschränkungen und Richtlinien zur Benennung Ihrer Dateien.

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

Hinweise 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 von leeren Ansichtsdateien und zum Hochladen von Dateien gibt es viele Möglichkeiten, wie ein Looker-Entwickler im Entwicklungsmodus einem LookML-Projekt Ansichtsdateien hinzufügen kann:

Wenn Sie eine neue Ansicht verwenden möchten, fügen Sie sie mit dem Parameter explore zu Ihrer Modelldatei hinzu oder verwenden Sie den Parameter join, um sie mit einer vorhandenen explorativen Datenanalyse in Ihrer Modelldatei zu verknüpfen.

Neue Ansicht aus einer vorhandenen Datenbanktabelle hinzufügen

Sie können eine Ansichtsdatei aus einer vorhandenen Datenbanktabelle erstellen, wenn Sie sich im Entwicklungsmodus befinden.

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

  2. Wählen Sie Create View from Table aus.

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

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

  5. Scrollen Sie zum Ende der Seite und wählen Sie Ansichten erstellen aus.

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

Dateien hochladen

Sie können auch Dateien von Ihrem Computer in Ihr Projekt hochladen. Das ist hilfreich, wenn Sie JSON-Datendateien oder LookML-Dateien lokal auf Ihrem Computer erstellt haben.

Wenn Sie eine Datei in Ihr Projekt hochladen möchten, verwenden Sie die Drag-and-drop-Funktion in der Looker-IDE:

  1. Rufen Sie die Projektdateien auf.
  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 das Element in einen anderen Ordner.

Dateien und Ordner löschen

Um einen Ordner oder eine Datei zu löschen, wählen Sie im Menü auf der linken Seite der IDE im Dreipunkt-Menü Datei-Löschenaus.

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 beim Löschen enthalten sind, einschließlich des Ordners und aller Dateien darin.

Dateien und Ordner im Bulk löschen

So löschen Sie Ordner und Dateien im Bulk:

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

  2. Wählen Sie die zu löschenden Elemente aus. Die Anzahl der ausgewählten Dateien wird neben der Kopfzeile Dateien auswählen angezeigt.

    • Wenn Sie einzelne Dateien auswählen oder die Auswahl aufheben möchten, maximieren Sie die Ordner der gewünschten Dateien und klicken Sie das Kästchen neben den Dateinamen an.
    • Wenn Sie ganze Ordner und deren Inhalte auswählen oder die Auswahl aufheben möchten, klicken Sie auf das Kästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt. Klicken Sie das Kästchen für das oberste Element im Bereich an, halten Sie die Umschalttaste gedrückt und aktivieren Sie das Kästchen für das letzte Element in der Liste. Es werden sowohl alle Elemente als auch alle dazwischenliegenden Elemente ausgewählt. Sie können auch einfach mit der Umschalttaste auf ein Element klicken, um das Element und alle darüber liegenden Elemente 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 Elemente, indem Sie Ja, Löschen auswählen. Wenn Sie zur Elementauswahl zurückkehren möchten, klicken Sie auf Abbrechen.

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

Elemente in ein archiviertes Projekt verschieben

Sie können eine einzelne Datei oder einen ganzen Ordner mit allen Inhalten an den neuen Speicherort ziehen:

Ziehen Sie eine Datei oder einen Ordner per Drag-and-drop in einen anderen Ordner. Der Zielordner muss nicht maximiert werden, um andere Ordner oder Dateien zu erhalten. Ein Ordner wird automatisch maximiert, wenn Sie den Mauszeiger darauf bewegen.

Dateien und Ordner im Bulk verschieben

So verschieben Sie Ordner und Dateien im Bulk:

  1. Wählen Sie oben im Bereich 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 Kopfzeile Dateien auswählen angezeigt.

    • Wenn Sie einzelne Dateien auswählen oder die Auswahl aufheben möchten, maximieren Sie die Ordner der gewünschten Dateien und klicken Sie das Kästchen neben den Dateinamen an.
    • Wenn Sie ganze Ordner und deren Inhalte auswählen oder die Auswahl aufheben möchten, klicken Sie auf das Kästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt. Klicken Sie das Kästchen für das oberste Element im Bereich an, halten Sie die Umschalttaste gedrückt und aktivieren Sie das Kästchen für das letzte Element in der Liste. Es werden sowohl alle Elemente als auch alle dazwischenliegenden Elemente ausgewählt. Sie können auch einfach mit der Umschalttaste auf ein Element klicken, um das Element und alle darüber liegenden Elemente in der Verzeichnisliste auszuwählen.

  3. Wählen Sie das Ordnersymbol Elemente verschieben aus, um die Option auszuwählen. In der IDE wird 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 klicken Sie auf Neuer Ordner, um einen neuen Ordner zu erstellen. Der Projektname zeigt den Dateipfad des ausgewählten Ordners oben auf der nächsten Menüseite an. 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 Ziel, indem Sie Verschieben auswählen, einen neuen Ordner im ausgewählten Ordner erstellen, indem Sie Neuer Ordner auswählen, oder zum Menü mit den Optionen für den Hauptordner zurückkehren, indem Sie im Dateipfad auf den Link des Projektnamens klicken.

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