LookML-Dateien und -Ordner verwalten

LookML-Projektdateien sind im Dateibrowserbereich der Looker IDE in Ordnern organisiert. Auf dieser Seite finden Sie 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 Dokumentationsseite Dateitypen in einem LookML-Projekt.

Wichtige Datei- und Ordnernamenskonventionen

Beachten Sie beim Erstellen von Dateien und Ordnern die folgenden Namenskonventionen:

  • Groß- und Kleinschreibung: Bei LookML wird zwischen Groß- und Kleinschreibung unterschieden. Achten Sie beim Benennen der Ordner auf die Konventionen Ihres Projekts. Wenn Sie in Ihrem Projekt beispielsweise ausschließlich Kleinbuchstaben verwenden, sollten Sie den Ordner views statt Views benennen. Dies ist besonders wichtig, wenn Sie den Pfad einer Datei angeben müssen, z. B. beim Einfügen von Dateien. Im Allgemeinen sollten Sie Kleinbuchstaben in Namen von LookML-Objekten und -Ordnern verwenden.
  • Leerzeichen und Sonderzeichen:Dateinamen dürfen keine Leerzeichen oder eines der folgenden Zeichen enthalten: / ? * : | " < > %
  • Dateiendung:Wenn Sie LookML-Dateien mit der Looker IDE erstellen, fügt Looker automatisch die Erweiterung .lkml an das Ende des Dateinamens an, wenn Sie die Erweiterung nicht manuell angeben. Wenn Sie beispielsweise den Dateinamen flights_data_tests eingeben, wird die Datei in Looker flights_data_tests.lkml genannt.
  • 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. Mit den Parametern label und alias wird der angezeigte Name geändert, während die zugrunde liegende URL für E-Mails oder andere Systeme beibehalten wird. Im Allgemeinen sollten Sie Vorkehrungen treffen, um Modelländerungen so minimal wie möglich zu halten. Wenn Sie ein Modell oder Objekt umbenennen müssen, aktualisieren Sie mit dem Inhaltsvalidierer alle Verweise auf das Modell oder Objekt.

Ordner erstellen

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

So erstellen Sie einen Ordner:

  1. Wählen Sie im entsprechenden Menü die Option 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. Sie können darauf zugreifen, indem Sie oben im Bereich Dateibrowser auf das Pluszeichen + klicken.
    • Wenn Sie einen neuen Unterordner in einem vorhandenen Ordner erstellen möchten, klicken Sie auf 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 Modell erstellen, erstellt Looker automatisch eine Modelldatei und Ansichtsdateien, die auf Ihrer Datenbank basieren. 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 der obersten Ebene der Verzeichnisstruktur erstellen möchten, verwenden Sie das Menü Datei oder Ordner hinzufügen. Sie können darauf zugreifen, indem Sie oben im Bereich Dateibrowser auf das Pluszeichen + klicken.
    • Wenn Sie eine neue Datei in einem vorhandenen Ordner erstellen möchten, klicken Sie auf das Dreipunkt-Menü Ordneroptionen des vorhandenen Ordners.

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

  3. Geben Sie im Dialogfeld Datei erstellen einen Namen für die neue Datei ein. Im Abschnitt Wichtige Namenskonventionen für Dateien und Ordner finden Sie Einschränkungen und Richtlinien für die Benennung von Dateien.

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

Hinweise zum Erstellen von Dateien

Beachten Sie beim Erstellen von Dateien Folgendes:

  • Wir empfehlen, die Looker IDE zu verwenden, um Ihrem LookML-Projekt Dateien hinzuzufügen. Sie können sie entweder in der Looker IDE erstellen oder in der Looker IDE hochladen. Wenn Sie Dateien außerhalb der Looker IDE erstellen und dann mit der Looker IDE aus dem Produktionszweig abrufen, müssen Sie die richtigen Benennungskonventionen verwenden und die Dateiendung .lkml (oder explore.lkml für Explore-Dateien) angeben. Wenn ein Dateiname nicht unterstützte Zeichen enthält, wird er im Dateibrowser der Looker IDE rot angezeigt. Sie können den Inhalt der Datei erst sehen, wenn Sie sie in einen Namen mit unterstützten Zeichen umbenannt haben. Außerdem wird die Datei in der Looker-IDE nicht angezeigt, wenn sie nicht die Endung .lkml hat.
  • Verwenden Sie nach dem Erstellen einer Datei den Parameter include, wenn Sie Elemente aus der Datei in anderen LookML-Dateien Ihres Projekts referenzieren möchten. Weitere Informationen finden Sie auf der Seite mit der Parameterdokumentation zu include.
  • Wenn Sie eine Datei erstellen, die in sieben oder mehr Ordnern verschachtelt ist, wird sie im Datei-Explorer nicht angezeigt.
  • Manifestdateien für Projekte können nur erstellt werden, wenn Sie in der Looker-IDE oben im Dateibrowser auf das Pluszeichen + klicken, um das Menü Datei oder Ordner hinzufügen zu öffnen. Außerdem muss das Projekt noch keine Manifestdatei haben. Das liegt daran, dass ein Projekt nur eine Manifestdatei haben kann und diese Manifestdatei sich auf der Stammebene der Verzeichnisstruktur des Projekts befinden muss.
  • Die Option Locale-Strings-Datei erstellen ist nur über das Symbol Datei oder Ordner hinzufügen + (Pluszeichen) oben im Dateibrowser der Looker IDE verfügbar. Sobald eine Gebietsschema-Zeichenfolgendatei erstellt (oder hochgeladen) wurde, können Sie sie in einen Ordner verschieben. Wenn Sie Gebietsschema-Zeichenfolgendateien zum Lokalisieren Ihres Modells erstellen und auch die integrierte UI-Lokalisierung von Looker nutzen möchten, müssen Sie Ihre Zeichenfolgendateien mit bestimmten Gebietsschemacodes benennen. Diese finden Sie auf der Dokumentationsseite Nutzer im Abschnitt Locale.
  • Wenn Sie eine explorative Datenanalysedatei erstellen, muss die Datei am Ende des Dateinamens die Erweiterung .explore.lkml haben. Wenn Sie die Datei hochladen, müssen Sie die vollständige Erweiterung .explore.lkml verwenden. Wenn Sie die Looker IDE verwenden, um die Datei mit der Option Generic LookML files (Allgemeine LookML-Dateien) zu erstellen, fügt Looker am Ende des Dateinamens .lkml hinzu, wenn die Erweiterung nicht vorhanden ist. Sie müssen jedoch den Teil .explore der Erweiterung manuell zum Dateinamen hinzufügen. Wenn Sie beispielsweise in der Looker IDE eine Explore-Datei namens flights erstellen möchten, können Sie entweder flights.explore oder flights.explore.lkml eingeben. Die Datei wird dann flights.explore.lkml genannt.

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. Neben den auf dieser Seite beschriebenen Methoden zum Erstellen leerer Ansichtsdateien und zum Hochladen von Dateien gibt es viele Möglichkeiten, wie Looker-Entwickler im Entwicklungsmodus einem LookML-Projekt Ansichtsdateien hinzufügen können:

Wenn Sie eine neue Ansicht verwenden möchten, fügen Sie sie Ihrer Modelldatei mit dem Parameter explore 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

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

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

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

  3. In Looker wird eine Liste der Tabellen angezeigt, die mit einer Ihrer Verbindungen verknüpft sind. Wenn Sie die Verbindung ändern möchten, verwenden Sie das Drop-down-Menü Verbindung oben links.

  4. Klicken Sie die Kästchen links neben den Tabellennamen an, aus denen Sie Ansichten erstellen möchten. 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-Dateien 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 und führen Sie die folgenden Schritte aus:

  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 das Element in einen anderen Ordner.

Dateien und Ordner löschen

Wenn Sie einen Ordner löschen, werden auch seine Inhalte gelöscht. Gehen Sie daher mit dem Löschen von Ordnern vorsichtig um. Führen Sie vor dem Löschen eines Ordners die folgenden Schritte aus:

  • Prüfen Sie, ob Sie die Dateien im Ordner löschen möchten, oder verschieben Sie die Dateien an einen anderen Speicherort, bevor Sie den Ordner löschen.
  • Prüfen Sie, ob der Ordner keine Dateien enthält, auf die in include-Anweisungen in Ihrem Projekt verwiesen wird. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie auf der Seite mit der Dokumentation des Parameters include im Abschnitt include mit IDE-Ordnern verwenden.

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

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

Wenn Sie eine Modelldatei löschen, wird das Modell nicht aus den Modellsätzen entfernt, zu denen es gehörte. Wenn eine neue Modelldatei mit demselben Namen wie ein gelöschtes Modell erstellt wird, wird das neue Modell in alle Modellsätze aufgenommen, die das gelöschte Modell enthielten. Das kann dazu führen, dass Unbefugte Zugriff auf die neue Modelldatei erhalten. Looker-Administratoren können Modellsätze bearbeiten und gelöschte Modelle entfernen, um dieses Problem zu vermeiden.

Dateien und Ordner im Bulk löschen

Wenn Sie einen Ordner löschen, werden auch seine Inhalte gelöscht. Gehen Sie also mit Bedacht vor. Führen Sie vor dem Löschen eines Ordners die folgenden Schritte aus:

  • Prüfen Sie, ob Sie die Dateien im Ordner löschen möchten, oder verschieben Sie die Dateien an einen anderen Speicherort, bevor Sie den Ordner löschen.
  • Prüfen Sie, ob der Ordner keine Dateien enthält, auf die in include-Anweisungen in Ihrem Projekt verwiesen wird. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie auf der Seite mit der Dokumentation des Parameters include im Abschnitt include mit IDE-Ordnern verwenden.

So löschen Sie mehrere Ordner und Dateien gleichzeitig:

  1. Wählen Sie oben im Bereich Dateibrowser das Symbol 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.

    • Wenn Sie einzelne Dateien auswählen oder die Auswahl aufheben möchten, maximieren Sie die Ordner und klicken Sie auf die Kästchen neben den Dateinamen.
    • Wenn Sie ganze Ordner und ihren Inhalt auswählen oder die Auswahl aufheben möchten, klicken Sie das Kästchen neben dem Ordnernamen an.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt und klicken Sie auf die gewünschten Elemente. Klicken Sie das Kästchen für das erste Element im Bereich an, halten Sie die Umschalttaste gedrückt und klicken Sie das Kästchen für das letzte Element in der Liste an. Sowohl die beiden Elemente als auch alle dazwischen liegenden Elemente werden ausgewählt. Sie können auch bei gedrückter Umschalttaste auf ein Element klicken, um es und alle Elemente davor in der Verzeichnisliste auszuwählen.

  3. Wählen Sie das Papierkorbsymbol Elemente löschen aus. In der IDE wird dann ein Dialogfeld mit den ausgewählten Elementen angezeigt.

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

  5. Klicken Sie auf das X in der Überschrift Dateien auswählen, um den Bulk-Bearbeitungsmodus zu beenden.

Elemente in einem Projekt mit Ordnern verschieben

Wenn Sie Dateien verschieben möchten, ziehen Sie eine Datei oder einen Ordner in einen anderen Ordner.

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

Wenn Sie den Pfad einer Datei ändern, müssen Sie alle include-Anweisungen in Ihrem Projekt entsprechend anpassen. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie auf der Seite mit der Parameterdokumentation von include im Abschnitt include mit IDE-Ordnern verwenden.

Wenn Sie den Pfad einer Datei ändern, löscht Git die Datei und erstellt eine neue Datei mit dem neuen Pfad. Das bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Wenn Sie den Git-Verlauf der Datei sehen möchten, bevor sie verschoben wurde, rufen Sie sie über die Git-Benutzeroberfläche an ihrem ursprünglichen Speicherort auf und sehen Sie sich dort den Git-Verlauf an. Dasselbe gilt für eine umbenannte Datei, da Git die Datei effektiv löscht und eine neue Datei mit einem anderen Namen erstellt.

Dateien und Ordner im Bulk-Verfahren verschieben

So verschieben Sie mehrere Ordner und Dateien gleichzeitig:

  1. Wählen Sie oben im Bereich Dateibrowser das Symbol 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.

    • Wenn Sie einzelne Dateien auswählen oder die Auswahl aufheben möchten, maximieren Sie die Ordner und klicken Sie auf die Kästchen neben den Dateinamen.
    • Wenn Sie ganze Ordner und ihren Inhalt auswählen oder die Auswahl aufheben möchten, klicken Sie das Kästchen neben dem Ordnernamen an.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt und klicken Sie auf die gewünschten Einträge. Klicken Sie das Kästchen für das erste Element im Bereich an, halten Sie die Umschalttaste gedrückt und klicken Sie das Kästchen für das letzte Element in der Liste an. So werden beide Elemente sowie alle dazwischen liegenden Elemente ausgewählt. Sie können auch bei gedrückter Umschalttaste auf ein Element klicken, um es und alle vorangehenden Dateien 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 Dialogfeld zur Ordnerauswahl angezeigt.

  4. Wählen Sie im Dialogfeld 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 enthält den Pfad des Ordners, den Sie oben auf der nächsten Menüseite 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. Sie können auch einen neuen Ordner im ausgewählten Ordner erstellen, indem Sie Neuer Ordner auswählen. Wenn Sie zum Hauptmenü mit den Ordneroptionen zurückkehren möchten, klicken Sie im Pfad auf den Link zum Projektnamen.

  6. Klicken Sie auf das X in der Überschrift Dateien auswählen, um den Bulk-Bearbeitungsmodus zu beenden.

Nachdem Sie den Pfad einer Datei geändert haben, müssen Sie alle include-Anweisungen in Ihrem Projekt entsprechend anpassen. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie auf der Seite mit der Dokumentation des Parameters include im Abschnitt include mit IDE-Ordnern verwenden.

Wenn Sie den Pfad einer Datei ändern, löscht Git die Datei und erstellt eine neue Datei mit dem neuen Pfad. Das bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Wenn Sie den Git-Verlauf der Datei sehen möchten, bevor sie verschoben wurde, rufen Sie sie über die Git-Benutzeroberfläche an ihrem ursprünglichen Speicherort auf und sehen Sie sich dort den Git-Verlauf an. Dasselbe gilt für eine umbenannte Datei, da Git die Datei effektiv löscht und eine neue Datei mit einem anderen Namen erstellt.