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.

Bevor Sie beginnen: Wichtige Datei- und Ordnerbenennungskonventionen

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. Das ist besonders dann 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.

Hinweis: Beachten Sie beim Erstellen von Ordnern, dass in LookML die Groß- und Kleinschreibung berücksichtigt wird. Achten Sie beim Benennen der Ordner auf die Konventionen Ihres Projekts. Das 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. Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien und Ordnern finden Sie in den wichtigen Hinweisen zum Erstellen von Dateien und Ordnern.

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.

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, wird er im Dateibrowser der Looker IDE rot angezeigt. Der Inhalt der Datei ist erst sichtbar, wenn Sie die Datei 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.

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:

   • 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
   • Dateien mit Gebietsschema-Strings mit der Dateiendung .strings.json***
   • Generische LookML-Dateien, die für die folgenden Dateitypen verwendet werden:
     • Dateien mit der Dateiendung .explore.lkml**** untersuchen
     • Datentestdateien mit der Dateiendung .lkml
     • Optimierungsdateien 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.

   ^** Manifestdateien für Projekte können nur erstellt werden, wenn das Projekt noch keine Manifestdatei hat. Klicken Sie dazu in der Looker-IDE oben im Dateibrowser auf das Pluszeichen +, um das Menü Datei oder Ordner hinzufügen zu öffnen. 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.

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 Improved LookML Generation (Verbesserte LookML-Generierung) aktiviert hat, wird oben im Bereich File Browser (Dateibrowser) im Menü Add file or folder + (Datei oder Ordner hinzufügen) zusätzlich zu den hier aufgeführten Optionen die Option Generate LookML from Database (LookML aus Datenbank generieren) angezeigt.

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:

• So erstellen Sie Ansichtsdateien auf Grundlage von Tabellen in einer Datenbank:

  • Ansichtsdateien aus Datenbanktabellen generieren, wenn Sie zum ersten Mal eine Verbindung zu Ihrer Datenbank herstellen, wie auf der Dokumentationsseite LookML-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 eine der auf dieser Seite beschriebenen Optionen verwenden, um die abgeleitete Tabelle dann manuell zu definieren, wie im Abschnitt Native abgeleitete Tabelle in LookML definieren der Dokumentationsseite Native abgeleitete Tabellen erstellen beschrieben
  • Looker erstellt die 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 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 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. 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 auf der Seite nach unten und wählen Sie Ansicht 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.

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

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.

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 Dreipunkt-Menü Dateioptionen des Elements im linken Bereich der IDE 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 gelöscht. 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 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 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 Papierkorbsymbol Elemente löschen aus. In der IDE wird dann ein Pop-up-Menü 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 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 maximiert, wenn Sie den Mauszeiger darauf bewegen.

Hinweis: Wenn Sie den Pfad einer Datei ändern, müssen Sie alle include-Anweisungen in Ihrem Projekt entsprechend dem neuen Dateipfad aktualisieren. 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 Dateipfad. 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 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 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. 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 Dateipfad auf den Link zum Projektnamen.

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 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 Dateipfad. 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.