Mit dem Dateibrowser der IDE arbeiten

Sie können über das Menü Entwickeln in Looker auf die Looker IDE zugreifen. Weitere Informationen und Optionen finden Sie unter Auf Projektdateien zugreifen.

Die Looker IDE unterstützt Ordner für Ihre Projektdateien. Ordner werden im linken Navigationsbereich der IDE angezeigt.

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.

In der Looker IDE bleiben die aktuell geöffnete Datei und der erweiterte oder minimierte Status des Bereichs Dateibrowser erhalten. 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 für importierte Projekte

Wenn Sie ein Projekt importieren, erstellt die Looker IDE automatisch einen imported_projects Ordner. 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 der 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 Updates in der Produktionsumgebung bereitgestellt haben. Wenn ein Entwickler Änderungen nicht bereitgestellt hat, spiegeln seine Branches die Dateistruktur wider, die beim letzten Abruf aus der Produktionsumgebung vorhanden war. Wenn das Projekt zu diesem Zeitpunkt eine flache Dateistruktur hatte, wird die Version der Datei des Entwicklers am 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, tritt beim Abruf aus der Produktionsumgebung nach der Migration ein Merge-Konflikt auf.
• Führen Sie mit allen Entwicklern eine temporäre Code-Sperrung durch, 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 unter den Entwicklern 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 sie 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 die Datei über die Git-Oberfläche am ursprünglichen Speicherort auf und sehen Sie sich den Git-Verlauf dort an.

Sobald alle Entwickler ihre Änderungen übertragen und übernommen haben und alle Arbeiten am Projekt pausiert wurden, 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 Updates 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. Rufen Sie die Produktionsumgebung ab.
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 include- und map_layer-Anweisungen 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. Führen Sie zum Übernehmen der Änderungen ein Commit durch.

9. Stellen Sie die Updates in der Produktionsumgebung bereit.

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