LookML-Dateien und -Ordner verwalten

LookML-Projektdateien werden im Bereich „Dateibrowser“ 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.

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

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

• Groß-/Kleinschreibung: LookML unterscheidet zwischen Groß- und Kleinschreibung. Achten Sie beim Benennen der Ordner auf die Konventionen Ihres Projekts. 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 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, 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. 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 ein 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. Dies ist sehr nützlich, wenn Sie include nur einen Teil der Ansichten verwenden möchten.

Hinweis: Beachten Sie beim Erstellen von Ordnern, dass LookML zwischen Groß- und Kleinschreibung unterscheidet. Achten Sie darauf, die Konventionen Ihres Projekts bei der Benennung Ihrer Ordner einzuhalten. Das ist wichtig, insbesondere wenn Sie den Pfad zu einer Datei 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. Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien und Ordnern finden Sie unter Wichtige Hinweise zum Erstellen von Dateien und Ordnern.

So erstellen Sie einen Ordner:

1. Wählen Sie aus dem 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 neues Projekt erstellen, können Sie automatisch eine Modelldatei generieren und Dateien basierend auf Ihrer Datenbank ansehen. Für vorhandene Projekte können Sie neue Dateien manuell erstellen.

Hinweis: Wir empfehlen, die Looker IDE zu verwenden, um Ihrem LookML-Projekt Dateien hinzuzufügen. Sie können sie entweder in der Looker IDE erstellen, wie weiter unten in diesem Abschnitt beschrieben, 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, zeigt der Dateibrowser der Looker IDE den Dateinamen in Rot an und Sie können den Inhalt der Datei erst sehen, wenn Sie die Datei mit unterstützten Zeichen umbenennen. Außerdem wird die Datei in der Looker-IDE nicht angezeigt, wenn sie nicht die Endung .lkml hat.

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.
   • 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:

   • Modelldateien mit der Dateiendung .model.lkml
   • Dateien mit der Dateiendung .view.lkml* ansehen
   • Projektmanifestdateien, die immer den Namen manifest.lkml** haben
   • Dashboarddateien mit der Dateiendung .dashboard.lookml
   • Dokumentdateien mit der Dateiendung .md
   • Gebietsschema-Stringdateien mit der Dateiendung .strings.json***
   • Generische LookML-Dateien, die für die folgenden Dateitypen verwendet werden:
     • Dateien ansehen mit der Dateiendung .explore.lkml****
     • Datentestdateien mit der Dateiendung .lkml
     • Suchfilterdateien mit der Dateiendung .lkml
     • Alle anderen Dateien, die Sie zum Speichern von LookML-Elementen verwenden
   Hinweis:

   ^* Im Abschnitt Überlegungen zum Erstellen von Ansichtsdateien auf dieser Seite finden Sie eine Anleitung zu alternativen Methoden zum Erstellen von Ansichtsdateien, einschließlich einer Anleitung zum Hinzufügen von Ansichtsdateien auf Grundlage von Datenbanktabellen.

   ^** Projektmanifestdateien können nur erstellt werden, wenn Sie in der Looker IDE oben im Dateibrowser auf das Pluszeichen + (Pluszeichen) klicken, um das Menü Datei oder Ordner hinzufügen zu öffnen. Außerdem ist es nur möglich, wenn das Projekt noch keine Manifestdatei hat. 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 Gebietsschema-Stringdatei erstellen ist nur über das Symbol Datei oder Ordner hinzufügen + (Plus) oben im Dateibrowser in der Looker IDE verfügbar. Sobald eine Sprachstringdatei erstellt (oder hochgeladen) wurde, können Sie die Datei aber in einen Ordner verschieben. Wenn Sie Sprachstringdateien erstellen, um Ihr Modell zu lokalisieren und gleichzeitig die native UI-Lokalisierung von Looker nutzen möchten, müssen Sie Ihre Stringdateien nach spezifischen Gebietsschemacodes benennen. Diese finden Sie auf der Dokumentationsseite Nutzer im Abschnitt „Gebietsschema“.

   ^**** 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 .explore.lkml-Erweiterung verwenden. Wenn Sie die Looker-IDE zum Erstellen der Datei mit der Option Generische LookML-Dateien verwenden, fügt Looker am Ende des Dateinamens .lkml hinzu, wenn die Erweiterung nicht vorhanden ist. Sie müssen den Teil .explore der Erweiterung aber trotzdem manuell zum Dateinamen hinzufügen. Wenn Sie beispielsweise mit 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.

3. Geben Sie im Pop-up Datei erstellen einen Namen für die neue Datei ein. Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien finden Sie in den wichtigen Hinweisen 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.

Wichtig: Verwenden Sie nach dem Erstellen der 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 Dokumentationsseite des Parameters include.

Hinweis: Wenn Ihr Looker-Administrator die Labs-Funktion Verbesserte LookML-Generierung aktiviert hat, wird oben im Bereich Dateibrowser im Menü Datei oder Ordner hinzufügen + (Pluszeichen) zusätzlich zu den hier aufgeführten Optionen die Option LookML aus Datenbank generieren angezeigt.

Ü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. 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:

• Ansichtsdateien basierend auf Tabellen in einer Datenbank erstellen:

  • Generieren von Ansichtsdateien aus Datenbanktabellen beim ersten Verbinden mit Ihrer Datenbank, wie auf der Dokumentationsseite Modell generieren beschrieben
  • Datenansichtsdateien aus Datenbanktabellen für ein Projekt generieren, das bereits mit einer Datenbank verbunden ist, wie im Abschnitt Neue Datenansicht aus einer vorhandenen Datenbanktabelle hinzufügen auf dieser Seite beschrieben

• Ansichtsdatei für eine abgeleitete Tabelle erstellen:

  • Mit einer leeren Ansichtsdatei beginnen und dann eine abgeleitete Tabelle wie im Abschnitt Native abgeleitete Tabelle in LookML definieren der Dokumentationsseite Native abgeleitete Tabellen erstellen manuell definieren
  • Looker erstellt den LookML-Code für die abgeleitete Tabelle aus einem Explore, wie im Abschnitt Native abgeleitete Tabellen auf der Grundlage eines Explores definieren der Dokumentationsseite Native abgeleitete Tabellen erstellen beschrieben.
  • Looker erstellt die LookML-Ableitungstabelle aus einer SQL Runner-Abfrage, wie auf der Dokumentationsseite Mit SQL Runner abgeleitete Tabellen erstellen beschrieben.

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 oben in der Liste der Projektdateien in der Looker IDE das Pluszeichen + auswählen. 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. Looker zeigt eine Liste der Tabellen an, die einer Ihrer Verbindungen zugeordnet sind. Wenn Sie die Verbindung ändern möchten, verwenden Sie das Drop-down-Menü Verbindung oben links.

4. Wählen Sie die 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 und maximieren, um auf alle verfügbaren Tabellen zuzugreifen.

5. Scrollen Sie auf der Seite nach unten und wählen Sie Ansicht 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. Das ist hilfreich, wenn Sie JSON-Dateien oder LookML-Dateien lokal auf Ihrem Computer erstellt haben.

Hinweis: In den wichtigen Hinweisen zum Erstellen von Dateien und Ordnern finden Sie Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien.

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

1. Rufen Sie Ihre 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.

Wichtig: Verwenden Sie nach dem Hochladen der Datei den Parameter include, wenn Sie in anderen LookML-Dateien Ihres Projekts auf die Datei oder Elemente aus der Datei verweisen möchten. Weitere Informationen finden Sie auf der Seite mit der Parameterdokumentation zu include.

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.

Hinweis: Wenn Sie einen Ordner löschen, werden auch seine Inhalte gelöscht. Gehen Sie daher beim Löschen von Ordnern mit Bedacht vor. Bevor Sie einen Ordner löschen, gehen Sie so vor:

• 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 Parameterdokumentation von include im Abschnitt include mit IDE-Ordnern verwenden.

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

Hinweis: 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 ein gelöschtes Modell entfernen, um dieses Problem zu vermeiden.

Dateien und Ordner im Bulk löschen

So löschen Sie mehrere Ordner und Dateien gleichzeitig:

Hinweis: Wenn Sie einen Ordner löschen, werden alle darin enthaltenen Inhalte entfernt. Prüfen Sie vor dem Löschen eines Ordners, ob Sie die darin enthaltenen Dateien wirklich löschen möchten. Wenn Sie sie behalten möchten, verschieben Sie die Dateien an einen anderen Speicherort, bevor Sie den Ordner löschen.

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 Abschnitt in der Verzeichnisliste auswählen möchten, halten Sie die Umschalttaste gedrückt und klicken Sie dann auf den gewünschten Bereich. 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 Elemente, indem Sie Ja, löschen auswählen, oder kehren Sie mit Abbrechen zur Artikelauswahl zurück.

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

Elemente in ein Ordnerprojekt verschieben

Wenn Sie Dateien verschieben möchten, ziehen Sie sie per Drag-and-drop in einen anderen Ordner.

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

Hinweis: Wenn Sie den Pfad einer Datei ändern, müssen Sie alle include-Anweisungen in Ihrem Projekt aktualisieren, damit sie dem neuen Dateipfad entsprechen. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie auf der Dokumentationsseite zum Parameter include im Abschnitt include mit IDE-Ordnern verwenden.

Beachten Sie außerdem, dass Git bei einer Änderung des Dateipfads die Datei effektiv löscht und eine neue Datei mit dem neuen Dateipfad erstellt. Dies bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Um den Git-Verlauf der Datei vor dem Verschieben zu sehen, wechseln Sie über Ihre Git-Oberfläche zur Datei am ursprünglichen Speicherort und sehen Sie sich den Git-Verlauf von dort an. Dasselbe gilt für eine umbenannte Datei, da Git die Datei effektiv löscht und eine neue Datei mit einem anderen Namen erstellt.

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.

   

   • 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, klicken Sie bei gedrückter Umschalttaste. 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 die Umschalttaste gedrückt halten und auf ein Element klicken, um es und alle Elemente darüber in der Verzeichnisliste auszuwählen.

3. Wählen Sie das Ordnersymbol Elemente verschieben aus, um eine Option auszuwählen. In der IDE wird dann ein Pop-up-Menü für die 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. Der Projektname zeigt den Dateipfad des ausgewählten Ordners oben auf der nächsten Menüsseite 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 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 im Dateipfad den Link für den Projektnamen auswählen.

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

Hinweis: Nachdem Sie den Pfad einer Datei geändert haben, müssen Sie alle include-Anweisungen in Ihrem Projekt aktualisieren, damit sie dem neuen Dateipfad entsprechen. 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.

Beachten Sie außerdem, dass Git bei einer Änderung des Dateipfads die Datei effektiv löscht und eine neue Datei mit dem neuen Dateipfad erstellt. 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.