Mit Ordnern in der IDE arbeiten

Die Looker-IDE unterstützt Ordner für Ihre Projektdateien. Ordner werden im linken Navigationsbereich der IDE angezeigt. Wenn Ihre Looker-Entwickler Ihre Projektdateien nicht in Ordnern organisiert haben, hat Ihr Projekt eine flache Dateistruktur, bei der die Dateien im Bereich Dateibrowser alphabetisch aufgeführt sind.

Wenn Sie Ihr Projekt in Ordner organisieren möchten, lesen Sie den Abschnitt Vorhandenes Projekt mit IDE-Ordnern organisieren auf dieser Seite.

Hier ist ein Beispielprojekt, bei dem ein Entwickler Ordner für verschiedene Arten von Projektdateien hinzugefügt hat, z. B. explores, models und views:

Sie können den IDE-Dateibrowser entweder über die Tastenkombination Befehlstaste + B (Mac) oder Strg + B (Windows) oder über das Dateibrowser-Symbol ein- oder ausblenden:

Klicken Sie auf die Symbole in der Symbolleiste oben im Steuerfeld Dateibrowser, um alle Ordner zu minimieren, Bulk-Bearbeitungen durchzuführen, nach einer Projektdatei zu suchen oder neue Ordner und neue Dateien zu erstellen:

Jede Datei oder jeder Ordner in der linken Seitenleiste enthält ein Menü, in dem die verfügbaren Aktionen für dieses Element angezeigt werden. Klicken Sie rechts neben dem Dateinamen auf das Dreipunkt-Menü, um das Menü zu öffnen. Wenn Sie ein Element mit einem langen Namen haben oder in mehreren Ordnern verschachtelt sind, können Sie auf das Menü zugreifen, indem Sie im linken Bereich scrollen:

Wenn Sie Ihre LookML-Dateien mit Ordnern organisieren, müssen Sie Ihre Änderungen per Commit speichern und in der Produktion bereitstellen, bevor andere Looker-Entwickler sie sehen können. Dies entspricht jeder Änderung, die Sie an Ihrem LookML-Projekt vornehmen.

Importierter Projektordner

Wenn Sie ein Projekt importieren, erstellt die Looker-IDE automatisch einen imported_projects-Ordner. Dateien aus lokalen Projekten und Remote-Projekten werden im Ordner imported_projects aufgeführt. Klicken Sie auf eine importierte Projektdatei, um ihren Inhalt anzusehen:

Da sie nicht bearbeitet werden können, sind importierte Projektdateien nicht sichtbar, wenn Sie Dateien in der IDE im Bulk bearbeiten.

Dateien und Ordner verwalten

Namenskonventionen für Dateien und Ordner

Beachten Sie beim Erstellen von Dateien und Ordnern Folgendes:

  • Bei LookML wird zwischen Groß- und Kleinschreibung unterschieden. Halten Sie bei der Benennung Ihrer Ordner die Konventionen für Ihr Projekt ein. Wenn Sie in Ihrem Projekt z. B. alle Kleinbuchstaben verwenden, sollten Sie den Ordner mit views und nicht mit Views benennen. Dies macht vor allem dann einen Unterschied, wenn Sie den Pfad einer Datei angeben müssen, z. B. beim Einbinden von Dateien. Generell empfiehlt es sich, bei der Benennung von LookML-Objekten und -Ordnern durchgängig Kleinbuchstaben zu verwenden.
  • Dateinamen dürfen keine Leerzeichen oder folgende Zeichen enthalten: / ? * : | " < > %
  • 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 einschließen. Wenn Sie beispielsweise den Dateinamen flights_data_tests eingeben, erhält Looker den Namen flights_data_tests.lkml.
  • Wenn Sie eine „Entdecken“-Datei erstellen möchten, muss die Datei die Erweiterung .explore.lkml am Ende des Dateinamens haben. Wenn Sie die Datei hochladen, müssen Sie die vollständige Erweiterung .explore.lkml verwenden. Wenn Sie die Looker-IDE zum Erstellen der Datei über die Option Allgemeine LookML-Dateien verwenden, fügt Looker am Ende des Dateinamens .lkml hinzu, wenn die Erweiterung nicht vorhanden ist. Sie müssen dem Dateinamen jedoch trotzdem den Teil .explore manuell hinzufügen. Wenn Sie beispielsweise mit der Looker-IDE eine Dateiendatei namens flights erstellen möchten, können Sie entweder flights.explore oder flights.explore.lkml eingeben. Die Datei hat dann den Namen flights.explore.lkml.
  • Wir empfehlen, die Looker-IDE zu Ihrem LookML-Projekt hinzuzufügen, entweder, indem Sie sie in der Looker-IDE erstellen oder in die Looker-IDE hochladen. Wenn Sie stattdessen Dateien außerhalb der Looker-IDE erstellen und dann die Looker-IDE zum Abrufen aus (Produktionszweig) verwenden, müssen Sie die richtigen Namenskonventionen einhalten und die Datei .lkml in den Dateinamen aufnehmen (oder explore.lkml für Dateien zum Erkunden). Wenn ein Dateiname nicht unterstützte Zeichen enthält, wird der Dateiname der Looker-IDE-Datei in Rot angezeigt und Sie können den Inhalt der Datei erst sehen, wenn Sie die Datei mit unterstützten Zeichen umbenennen. Außerdem wird die Datei von der Looker-IDE überhaupt nicht angezeigt, wenn die Datei nicht die Erweiterung .lkml hat.

Ordner erstellen

Sie können Ordner für verschiedene Dateitypen erstellen, z. B. Dateien ansehen oder Modelldateien. Sie können sogar Unterordner erstellen, was sehr hilfreich ist, wenn Sie nur einen Teil der Ansichten includeansehen möchten.

Beachten Sie beim Erstellen von Ordnern, dass die Groß- und Kleinschreibung bei LookML berücksichtigt wird. Halten Sie bei der Benennung Ihrer Ordner die Konventionen für Ihr Projekt ein. Wenn Sie in Ihrem Projekt z. B. alle Kleinbuchstaben verwenden, sollten Sie den Ordner mit views und nicht mit Views benennen. Dies macht vor allem dann einen Unterschied, wenn Sie den Pfad einer Datei angeben müssen, z. B. beim Einbinden von Dateien. Generell empfiehlt es sich, bei der Benennung von LookML-Objekten und -Ordnern durchgängig Kleinbuchstaben zu verwenden. Informationen zu Einschränkungen und Richtlinien für die Benennung von Dateien und Ordnern finden Sie in den Namenskonventionen.

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ü + oben im Steuerfeld Dateibrowser.
    • Wenn Sie einen neuen Unterordner in einem vorhandenen Ordner erstellen möchten, verwenden Sie das Dreipunkt-Menü für den vorhandenen Ordner.
  2. Geben Sie einen Namen für den neuen Ordner ein.
  3. Klicken Sie auf Erstellen.

Der neue Ordner wird dem Navigationsbereich hinzugefügt.

Erstellen von Dateien

Wenn Ihr Looker-Administrator die Labs-Funktion Verbesserte LookML-Generierung aktiviert hat, wird im Menü + oben im Steuerfeld Dateibrowser zusätzlich zu den hier aufgeführten Optionen die Option LookML from Database generieren angezeigt.

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ü + oben im Steuerfeld Dateibrowser.
    • Wenn Sie eine neue Datei in einem vorhandenen Ordner erstellen möchten, verwenden Sie das Dreipunkt-Menü für den vorhandenen Ordner.
  2. Wählen Sie den Typ der LookML-Datei aus, die Sie erstellen möchten. Sie können die folgenden Dateitypen erstellen:

    * Projektmanifestdateien können nur über das +-Symbol oben im Dateibrowser der Looker-IDE und nur erstellt werden, wenn für das Projekt noch keine Manifestdatei vorhanden ist. Der Grund dafür ist, dass ein Projekt nur eine Manifestdatei haben kann und diese sich auf der Stammebene der Verzeichnisstruktur des Projekts befinden muss.
    ** Die Option Locale Strings-Datei erstellen ist nur über das +-Symbol oben im Dateibrowser der Looker-IDE verfügbar. Sobald eine Sprache-Sprache-Datei erstellt oder hochgeladen wurde, können Sie die Datei in einen Ordner verschieben.

  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 in den Namenskonventionen für Dateien.

  4. Klicken Sie auf Erstellen. Die neue Datei wird dort angezeigt, wo Sie sie erstellt haben. Sie können sie bei Bedarf ganz einfach in einen anderen Ordner verschieben.

Nachdem Sie die Datei erstellt haben, müssen Sie den Parameter include verwenden, wenn Sie auf Elemente der Datei in anderen LookML-Dateien Ihres Projekts verweisen möchten. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter include.

Dateien hochladen

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

Informationen zu Beschränkungen und Richtlinien für die Benennung von Dateien finden Sie in den Namenskonventionen.

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.

Nachdem Sie die Datei hochgeladen haben, müssen Sie den Parameter include verwenden, wenn Sie in anderen LookML-Dateien Ihres Projekts auf die Datei oder die Elemente aus der Datei verweisen möchten. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter include.

Dateien und Ordner löschen

Sie können einen Ordner oder eine Datei löschen, indem Sie im linken Navigationsbereich der IDE im Dreipunkt-Menü des Elements Löschen auswählen.

Beim Löschen eines Ordners werden auch dessen Inhalte gelöscht. Seien Sie daher vorsichtig, wenn Sie Ordner löschen. Bevor Sie einen Ordner löschen, gehen Sie folgendermaßen vor:
Bestätigen Sie, dass Sie die Dateien im Ordner löschen möchten, oder verschieben Sie die Dateien an einem anderen Speicherort, bevor Sie den Ordner löschen.
Achten Sie darauf, dass 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 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-Fenster wird angegeben, wie viele Elemente beim Löschen enthalten sind. Dazu gehören der Ordner und alle Dateien im Ordner.

Elemente in ein Ordnerprojekt verschieben

Sie können eine einzelne Datei oder einen gesamten Ordner mit allen Inhalten an eine neue Stelle ziehen:

Ziehen Sie eine Datei oder einen Ordner in einen anderen Ordner. Der Zielordner muss nicht erweitert werden, um andere Ordner oder Dateien zu empfangen. 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 dem neuen Dateipfad aktualisieren. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie im Abschnitt include mit IDE-Ordnern verwenden auf dieser Seite.

Beachten Sie außerdem, dass Git die Datei löscht und eine neue Datei mit dem neuen Dateipfad erstellt, wenn Sie den Pfad einer Datei ändern. Das bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Wenn Sie sich den Git-Verlauf der Datei vor dem Verschieben ansehen möchten, rufen Sie über die Git-Oberfläche die Datei am ursprünglichen Speicherort auf und rufen Sie dort den Git-Verlauf auf. Dasselbe gilt für eine umbenannte Datei, da Git die Datei effektiv löscht und eine neue Datei mit einem anderen Namen erstellt.

Bulk-Bearbeitung von Dateien und Ordnern

Sie können auch mehrere Ordner und Dateien auswählen, die an neue Speicherorte verschoben oder gelöscht werden sollen.

Mehrere Dateien und Ordner gleichzeitig verschieben

So verschieben Sie Ordner und Dateien im Bulk:

  1. Klicken Sie oben im Bereich Dateibrowser auf das Symbol Bulk-Bearbeitung.
  2. Wählen Sie die Elemente aus, die Sie verschieben möchten. Die Anzahl der ausgewählten Dateien wird lila neben der Überschrift Dateien auswählen angezeigt.
    • Wenn Sie einzelne Dateien auswählen oder ihre Auswahl aufheben möchten, maximieren Sie die Ordner und klicken Sie auf die Kästchen neben den Dateinamen.
    • Wenn Sie ganze Ordner und deren Inhalte auswählen oder ihre Auswahl aufheben möchten, klicken Sie auf das Kästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, klicken Sie bei gedrückter Umschalttaste darauf. Klicken Sie auf das Kästchen für das oberste Element im Bereich, halten Sie die Umschalttaste gedrückt und klicken Sie dann auf das Kästchen für das letzte Element in der Liste. Es werden sowohl die Elemente als auch alle dazwischenliegenden Elemente ausgewählt. Sie können auch einfach bei gedrückter Umschalttaste auf ein Element klicken, um das Element und dessen Inhalt in der Verzeichnisliste auszuwählen.
  3. Klicken Sie auf das Ordnersymbol Mehrere Elemente gleichzeitig verschieben, um eine Option auszuwählen. Die IDE zeigt dann ein Pop-up-Menü zur Ordnerauswahl an.
  4. Wählen Sie im Pop-up-Menü 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, klicken Sie auf Verschieben, ohne einen Ordner auszuwählen.
  5. Bestätigen Sie das Ziel, indem Sie auf Verschieben klicken, erstellen Sie einen neuen Ordner im ausgewählten Ordner, indem Sie auf Neuer Ordner klicken, oder kehren Sie zum Hauptmenü mit den Ordneroptionen zurück, indem Sie auf den Link für den Projektnamen im Dateipfad klicken.
  6. Klicken Sie im Header Dateien auswählen auf das X, um den Bulk-Bearbeitungsmodus zu beenden.

Aktualisieren Sie nach dem Ändern des Pfads einer Datei alle include-Anweisungen in Ihrem Projekt, damit sie mit dem neuen Dateipfad übereinstimmen. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie im Abschnitt include mit IDE-Ordnern verwenden auf dieser Seite.

Beachten Sie außerdem, dass Git die Datei löscht und eine neue Datei mit dem neuen Dateipfad erstellt, wenn Sie den Pfad einer Datei ändern. Das bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Wenn Sie sich den Git-Verlauf der Datei vor dem Verschieben ansehen möchten, rufen Sie über die Git-Oberfläche die Datei am ursprünglichen Speicherort auf und rufen Sie dort den Git-Verlauf auf. 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 löschen

So löschen Sie Ordner und Dateien im Bulk:

Wenn Sie einen Ordner löschen, wird der gesamte Inhalt gelöscht. Prüfen Sie vor dem Löschen eines Ordners, ob Sie die Dateien im Ordner 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. Klicken Sie oben im Bereich Dateibrowser auf das Symbol Bulk-Bearbeitung.
  2. Wählen Sie die Elemente aus, die Sie löschen möchten. Die Anzahl der ausgewählten Dateien wird lila neben der Überschrift Dateien auswählen angezeigt.
    • Wenn Sie einzelne Dateien auswählen oder ihre Auswahl aufheben möchten, maximieren Sie die Ordner und klicken Sie auf die Kästchen neben den Dateinamen.
    • Wenn Sie ganze Ordner und deren Inhalte auswählen oder ihre Auswahl aufheben möchten, klicken Sie auf das Kästchen neben dem Ordnernamen.
    • Wenn Sie einen ganzen Bereich der Verzeichnisliste auswählen möchten, klicken Sie bei gedrückter Umschalttaste darauf. Klicken Sie auf das Kästchen für das oberste Element im Bereich, halten Sie die Umschalttaste gedrückt und klicken Sie dann auf das Kästchen für das letzte Element in der Liste. Es werden sowohl die Elemente als auch alle dazwischenliegenden Elemente ausgewählt. Sie können auch einfach bei gedrückter Umschalttaste auf ein Element klicken, um das Element und dessen Inhalt in der Verzeichnisliste auszuwählen.
  3. Klicken Sie auf das Papierkorbsymbol Elemente löschen. 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 auf Ja, löschen klicken, oder kehren Sie zur Elementauswahl zurück, indem Sie auf Abbrechen klicken.
  5. Klicken Sie im Header Dateien auswählen auf das X, um den Bulk-Bearbeitungsmodus zu beenden.

include mit IDE-Ordnern verwenden

Nachdem Sie Ihre Projektdateien in Ordnern organisiert haben, müssen Sie den Pfad zur Datei angeben, wenn Sie die include-Anweisung verwenden.

Beachten Sie bei der Verwendung von include, dass bei LookML zwischen Groß- und Kleinschreibung unterschieden wird. Wenn Sie den Pfad einer Datei angeben, müssen Sie die Groß-/Kleinschreibung mit der Datei und den Ordnern im Pfad abgleichen. Befindet sich Ihre Datei beispielsweise im Ordner Views, müssen Sie diese Groß- und Kleinschreibung im Parameter include abgleichen. In diesem Fall geben Sie include: "/Views/accidents.view" an. Generell empfiehlt es sich, beim Benennen von LookML-Objekten und -Ordnern kleingeschrieben zu bleiben.

Sie können in der include-Anweisung absolute oder relative Pfade verwenden (Beispiele finden Sie im Abschnitt Pfadsyntax). Außerdem können Sie die Platzhalter * und ** verwenden, um mehrere Dateien gleichzeitig einzufügen. Beispiele finden Sie auf dieser Seite im Abschnitt Platzhalterbeispiele.

Angenommen, diese Verzeichnisstruktur befindet sich in Ihrem Projekt:

Die folgenden Anweisungen enthalten die Ansicht products, die Ansicht order_facts und alle Ansichten im Verzeichnis /views/users/:

include: "/views/products.view"
include: "/views/orders/order_facts.view"
include: "/views/users/*.view"

Wenn Sie den Pfad einer Datei ändern, müssen Sie alle include-Anweisungen in Ihrem Projekt aktualisieren, damit sie mit dem neuen Pfad der Datei übereinstimmen. Unter Umständen sehen Sie auf Ihren alten include-Anweisungen Warnungen zur LookML-Validierung, wenn sie nicht mehr auf vorhandene Dateien oder Dateipfade verweisen. Außerdem kann es vorkommen, dass LookML-Validierungsfehler für Objekte, auf die verwiesen wird, nicht mehr gefunden werden, weil sich ihre Dateipfade geändert haben.

Praktischer Tipp: Wenn Sie Platzhalter verwenden, können Sie prüfen, welche Dateien enthalten sind. Bewegen Sie dazu den Mauszeiger auf das Informationssymbol neben der Zeilennummer in der Datei. Sie können auch auf die Anweisung include klicken und sich die Soforthilfe ansehen:

Praktischer Tipp: Sie können den Pfad für eine Datei kopieren. Wählen Sie dazu in der Looker-IDE im Dreipunkt-Menü der Datei die Option Dateipfad kopieren aus:

Pfadsyntax

Hier sind einige Beispielsyntaxen, die Sie zum Einbinden von Dateien verwenden können:

Syntax Beschreibung
PATH Relativer Pfad ab dem aktuellen Speicherort der Datei.
./PATH Relativer Pfad ab dem aktuellen Speicherort der Datei. Dieses Beispiel verweist auf dieselbe Datei wie im Beispiel oben: PATH.
../PATH Relativer Pfad ab dem übergeordneten Verzeichnis der aktuellen Datei.
/PATH Absoluter Pfad, der vom Stammverzeichnis des aktuellen Projekts aus beginnt.
//PROJECT_NAME/PATH Absoluter Pfad, der vom Stamm eines importierten Projekts namens PROJECT_NAME ausgeht.

Beispiele für Platzhalter

Verwenden Sie bei LookML-Suchfiltern keine Platzhalter in Ihren Includes. Bei der Optimierung von LookML wird die Reihenfolge der enthaltenen Elemente berücksichtigt. Durch die Verwendung von Platzhaltern in Ihren einschließenden Elementen können Sie nicht die Reihenfolge steuern, in der die einzelnen Dateien enthalten sind. Weitere Informationen zu Suchfiltern finden Sie auf der Dokumentationsseite LookML-Suchfilter.

Im Folgenden findest du einige Beispiele für Platzhalter. Du kannst PATH durch die Pfadsyntax der vorherigen Tabelle ersetzen:

Syntax Beschreibung
PATH/*.view Platzhalter für Dateien mit der Endung .view um PATH.
PATH/*.view.lkml Platzhalter für Dateien mit der Endung .view.lkml um PATH.

Da Ansichtsdateien die Erweiterung .view.lkml haben, wird in diesem Beispiel dieselbe Datei wie im vorherigen Beispiel PATH/*.view angegeben. Der .lkml-Teil wird weder in der IDE noch der .lkml-Teil angezeigt, der für include-Anweisungen erforderlich ist. Sie können jedoch Platzhalter verwenden, um diesen gemeinsamen Teil der Dateiendung zu nutzen. Auf der Dokumentationsseite zu LookML-Projektdateien finden Sie eine Liste der Projektdateierweiterungen.
PATH/*.lkml Platzhalter für Dateien mit der Endung .lkml um PATH.

Beachten Sie, dass mehrere Dateitypen .lkml als letzten Teil der Dateierweiterung verwenden, wie .view.lkml und .model.lkml. Der .lkml-Teil wird weder in der IDE noch der .lkml-Teil angezeigt, der für include-Anweisungen erforderlich ist. Sie können jedoch Platzhalter verwenden, um diesen gemeinsamen Teil der Dateiendung zu nutzen. Auf der Dokumentationsseite zu LookML-Projektdateien finden Sie eine Liste der Projektdateierweiterungen.
PATH/myfile.* Platzhalterdateien, die myfile heißen, mit einem beliebigen Erweiterungstyp bei PATH.
PATH/myfile.*.lkml Platzhalter, der Dateien mit dem Namen „myfile“ mit einem beliebigen .lkml-Erweiterungstyp unter PATH entspricht.
PATH/my*file.view Platzhalter für Dateien, die mit my beginnen und mit file.view auf PATH enden.
PATH/my*fi*le.view Platzhalter für Dateien, die mit my beginnen, gefolgt von einigen Zeichen, gefolgt von fi, gefolgt von weiteren Zeichen. Die Dateiendung endet mit le.view am PATH.
PATH/*/myfile.lkml Platzhalter für den Platzhalternamen (entspricht nur einer einzigen Verschachtelungsebene). Stimmt mit allen myfile.lkml-Dateien in allen direkten untergeordneten Verzeichnissen von PATH überein.
PATH/**/my_file.view Rekursiver Platzhalterabgleich (mit einer beliebigen Verschachtelung beliebig) für alle Dateien mit dem Namen my_file.view.lkml in PATH und alle Unterverzeichnissen.
PATH/**/*.view Rekursiver Platzhalter, der alle Dateien mit der Endung „.view.lkml“ in den Unterverzeichnissen von „PATH“ abgleicht.
PATH/**/my_folder/myfile.view Wiederkehrender Platzhalter, der mit dem Unterpfad /my_folder/myfile.view in beliebiger Tiefe unter PATH übereinstimmt.

map_layer mit IDE-Ordnern verwenden

Wenn Sie IDE-Ordner für Ihr Projekt aktiviert haben, müssen Sie den Dateipfad verwenden, wenn Sie eine Projektdatei für map_layer angeben:

map_layer: neighborhoods {
  file: "/maps/my_neighborhoods.json"
}

Vorhandenes Projekt mit IDE-Ordnern organisieren

Wenn Ihr Projekt zuvor die alte flache Dateistruktur hatte, können Sie diese Struktur beibehalten. Wenn Sie sich jedoch dafür entscheiden, Ihre Projektdateien in Ordnern zu organisieren, empfehlen wir dringend, folgende Vorbereitungen zu treffen:

  • Planen Sie die Dateistruktur im Voraus mit allen Entwicklern.
  • Achten Sie darauf, dass alle Looker-Entwickler alle ihre Updates in der Produktion bereitgestellt haben. Bei Entwicklern, deren Bereitstellung noch nicht bereitgestellt wurde, wird deren Dateistruktur bei der letzten Erstellung aus der Produktion widergespiegelt. Wenn das Projekt zu diesem Zeitpunkt eine flache Dateistruktur hatte, wird die Entwicklungsversion der Datei am ursprünglichen Speicherort in die Produktion verschoben, sodass Sie am Ende zwei Kopien der Datei erhalten. Wenn ein Entwickler während der Migration von Ordnern die Bereitstellung aufgehoben hat, tritt dieser Konflikt auf, wenn er nach der Migration die Produktionsversion abruft.
  • Ergreifen Sie für alle Ihre Entwickler ein vorübergehendes Einfrieren des Codes, bis das Projekt vollständig in die neue Verzeichnisstruktur migriert wurde.
  • Weisen Sie einen einzelnen Entwickler zu, der die Dateien verschiebt. Bei der folgenden Anleitung wird davon ausgegangen, dass ein einzelner Entwickler das Projekt in IDE-Ordner migriert. Wenn mehrere Entwickler Dateien verschieben müssen, teilen Sie die Aufgabe auf die Entwickler auf, um Konflikte bei der Zusammenführung zu vermeiden. Wenn Sie auf Zusammenführungskonflikte stoßen, erhalten Sie auf der Dokumentationsseite Versionsverwaltung und Bereitstellung verwenden Informationen zur Behebung.

Beachten Sie, dass Sie beim Verschieben einer Datei in Git die Datei löschen und eine neue Datei mit einem neuen Dateipfad erstellen. Das bedeutet, dass der Git-Verlauf für die Datei leer ist, da Git sie als neue Datei betrachtet. Wenn Sie sich den Git-Verlauf der Datei vor dem Verschieben ansehen möchten, rufen Sie über die Git-Oberfläche die Datei am ursprünglichen Speicherort auf und rufen Sie dort den Git-Verlauf auf.

Sobald alle Ihre Entwickler ihre Änderungen per Push-Befehl übertragen und sie angehalten haben, können Sie das Projekt in die neue Verzeichnisstruktur migrieren.

Weisen Sie einen Entwickler zu, der die folgenden Schritte ausführt:

  1. Prüfen Sie, ob alle Aktualisierungen in allen Entwicklungszweigen für die Produktion bereitgestellt wurden. Dazu gehören die Entwicklungszweige des Entwicklers, der die Migration zu IDE-Ordnern durchführt.
  2. Prüfen Sie, ob alle anderen Entwickler keine Änderungen mehr am Projekt vorgenommen haben.
  3. Abrufen aus der Produktion:
  4. Erstellen Sie die Ordner des Projekts.
  5. Verschieben Sie die Projektdateien in die Ordner, entweder jeweils eine Datei oder per Bulk-Bearbeitung.
  6. LookML des Projekts Es sollten mehrere LookML-Fehler und -Warnungen vorliegen, da die include- und map_layer-Anweisungen auf Dateispeicherorte verweisen, die während dieses Vorgangs wahrscheinlich verschoben wurden.
  7. Aktualisieren Sie alle include- und map_layer-Anweisungen in Ihrem Projekt entsprechend dem neuen Pfad der Datei. Außerdem kann es vorkommen, dass LookML-Validierungsfehler für Objekte, auf die verwiesen wird, nicht mehr gefunden werden, weil sich ihre Dateipfade geändert haben. Informationen zur Verwendung von include mit IDE-Ordnern finden Sie im Abschnitt include mit IDE-Ordnern verwenden und im Abschnitt map_layer mit IDE-Ordnern verwenden auf dieser Seite.

    Tipp für Mobilgeräte: Sie können Platzhalter verwenden, um vorübergehend Warnungen und Fehler zu korrigieren, die durch include-Anweisungen in LookML generiert werden. Wenn Sie beispielsweise Dateien ansehen möchten, können Sie include: "/**/*.view" angeben, damit alle Dateien in allen Projektordnern enthalten sind. Dadurch werden Probleme bei der LookML-Validierung während der Entwicklung vermieden. Das ist jedoch keine langfristige Lösung, da sich die Leistung beeinträchtigen lässt, wenn mehr Dateien als benötigt enthalten sind.

  8. Übernehmen Sie die Änderungen.

  9. Stellen Sie die Updates für die Produktion bereit.

  10. Informieren Sie die anderen Looker-Entwickler darüber, dass sie jetzt Aktualisierungen aus der Produktion abrufen und im Projekt fortsetzen können.