Mit dem Dateibrowser der IDE arbeiten

Sie können Ihre Looker-Projektdateien effektiver organisieren, indem Sie Ordner in der Looker IDE verwenden. Ordner verhindern eine flache, alphabetisch sortierte Dateistruktur und erleichtern so die Verwaltung und Navigation in komplexen Projekten. Sie können über das Menü Entwickeln in Looker auf die Looker IDE zugreifen. Ordner werden im linken Navigationsbereich der IDE angezeigt. Weitere Informationen und andere Optionen für den Zugriff auf Projektdateien finden Sie unter Auf Projektdateien zugreifen.

Wenn Ihr Looker-Projekt nicht in Ordnern organisiert ist, hat es eine flache Dateistruktur. Die Dateien werden alphabetisch im Bereich Dateibrowser aufgeführt. Informationen zum Aktualisieren Ihres Projekts, damit IDE-Ordner verwendet werden, finden Sie unter Vorhandenes Projekt mit IDE-Ordnern organisieren.

Die Looker IDE speichert Ihre geöffnete Datei und den erweiterten oder minimierten Status des Bereichs Dateibrowser. Sie können die Persistenz in den IDE-Einstellungen zurücksetzen.

Sie können die Symbole in der Symbolleiste oben im Bereich Dateibrowser auswählen, um alle Ordner zu minimieren, Dateien und Ordner zu verschieben und zu löschen, nach einer Projektdatei zu suchen oder neue Ordner und neue Dateien zu erstellen.

Ordner „Importierte Projekte“

Wenn Sie ein Projekt importieren, erstellt die Looker IDE automatisch den Ordner imported_projects. Im imported_projects Ordner werden Dateien aus lokalen Projekten und Remote-Projekten aufgeführt. Wählen Sie eine importierte Projektdatei aus der Liste der Dateien in imported_projects aus, um den Inhalt dieser Datei anzusehen.

Da importierte Projektdateien nicht bearbeitet werden können, sind sie nicht sichtbar, wenn Sie Dateien in der IDE per Bulk-Bearbeitung verschieben oder löschen.

Vorhandenes Projekt mit IDE-Ordnern organisieren

Wenn Ihr Projekt zuvor die flache Dateistruktur hatte oder Sie die Dateien in einem Ordner neu organisieren möchten, können Sie diese Struktur beibehalten. Wenn Sie Ihre Projektdateien jedoch in Ordnern organisieren möchten, empfehlen wir dringend, die folgenden Vorbereitungen zu treffen:

• Planen Sie die Dateistruktur im Voraus mit allen Entwicklern.
• Achten Sie darauf, dass alle Looker-Entwickler alle ihre Aktualisierungen in der Produktionsumgebung bereitgestellt haben. Wenn ein Entwickler Änderungen nicht bereitgestellt hat, spiegeln seine Branches die Dateistruktur wider, die beim letzten Pull aus der Produktionsumgebung vorhanden war. Wenn das Projekt zu diesem Zeitpunkt eine flache Dateistruktur hatte, wird die Version der Datei des Entwicklers an ihrem ursprünglichen Speicherort in der Produktionsumgebung bereitgestellt. So erhalten Sie zwei Kopien der Datei. Wenn ein Entwickler außerdem während der Migration zu Ordnern Änderungen nicht bereitgestellt hat, kommt es zu einem Merge-Konflikt, wenn er nach der Migration aus der Produktionsumgebung pullt.
• Führen Sie eine temporäre Code-Freeze-Phase mit allen Entwicklern ein, bis das Projekt vollständig zur neuen Verzeichnisstruktur migriert wurde.
• Weisen Sie einem einzelnen Entwickler die Aufgabe zu, die Dateien zu verschieben. Bei der folgenden Vorgehensweise wird davon ausgegangen, dass ein einzelner Entwickler das Projekt zu IDE-Ordnern migriert. Wenn mehrere Entwickler Dateien verschieben müssen, teilen Sie die Aufgabe auf die Entwickler auf, um Merge-Konflikte zu vermeiden. Informationen zum Beheben von Merge-Konflikten finden Sie auf der Dokumentationsseite Versionsverwaltung verwenden und bereitstellen.

Hinweis: Wenn Sie eine Datei in Git verschieben, löschen Sie die Datei und erstellen eine neue Datei mit einem 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 vor dem Verschieben sehen möchten, rufen Sie über Ihre Git-Oberfläche die Datei an ihrem ursprünglichen Speicherort auf und sehen Sie sich den Git-Verlauf dort an.

Sobald alle Entwickler ihre Änderungen gepusht und committet und alle Arbeiten am Projekt pausiert haben, können Sie das Projekt zur neuen Verzeichnisstruktur migrieren.

Weisen Sie einem einzelnen Entwickler die Aufgabe zu, alle folgenden Schritte auszuführen:

1. Prüfen Sie, ob alle Aktualisierungen in allen Entwicklungs-Branches in der Produktionsumgebung bereitgestellt wurden. Dazu gehören auch die Entwicklungs-Branches des Entwicklers, der die Migration zu IDE-Ordnern durchführt.
2. Prüfen Sie, ob alle anderen Entwickler keine Änderungen mehr am Projekt vornehmen.
3. Pull aus der Produktionsumgebung.
4. Erstellen Sie die Ordner des Projekts.
5. Verschieben Sie die Projektdateien in die Ordner, entweder einzeln oder per Bulk-Bearbeitung.
6. Validieren Sie das LookML des Projekts. Es ist zu erwarten, dass mehrere LookML-Fehler und ‑Warnungen auftreten, da die Anweisungen include und map_layer Verweise auf Dateispeicherorte verwenden, die während dieser Prozedur wahrscheinlich verschoben wurden.

7. Aktualisieren Sie alle Anweisungen include und map_layer in Ihrem Projekt, damit sie dem neuen Pfad der Datei entsprechen. Außerdem werden möglicherweise LookML-Validierungsfehler für referenzierte Objekte angezeigt, die nicht mehr gefunden werden können, weil sich ihre Dateipfade geändert haben. Weitere Informationen finden Sie in der Dokumentation zu using include mit IDE-Ordnern und zu using map_layer mit IDE-Ordnern.

   Tipp: Sie können Platzhalter verwenden, um LookML-Validierungswarnungen und ‑Fehler, die durch include Anweisungen verursacht werden, vorübergehend zu beheben. Wenn Sie beispielsweise Ansichtsdateien verwenden, können Sie include: "/**/*.view" angeben, um alle Dateien in allen Projektordnern einzuschließen. So werden LookML-Validierungsprobleme vermieden, während Sie weiterentwickeln. Dies ist jedoch keine empfohlene Lösung für die langfristige Nutzung, da das Einbeziehen von mehr Dateien als erforderlich die Leistung beeinträchtigen kann.

8. Commiten Sie die Änderungen.

9. Stellen Sie die Aktualisierungen in der Produktionsumgebung bereit.

10. Informieren Sie die anderen Looker-Entwickler, dass sie die Aktualisierungen jetzt aus der Produktionsumgebung pullen und die Entwicklung im Projekt fortsetzen können.