Mit dem IDE-Dateibrowser arbeiten

Am einfachsten können Sie über das Looker-Menü Entwickeln auf die Looker-IDE zugreifen. Weitere Informationen und andere 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 Ihre Looker-Entwickler Ihre Projektdateien nicht in Ordnern organisiert haben, hat Ihr Projekt eine einfache Dateistruktur. Die Dateien sind im Bereich Dateibrowser alphabetisch aufgeführt.

Hier ist ein Beispielprojekt, bei dem ein Entwickler Ordner für verschiedene Arten von Projektdateien wie Explores, Modelle und Ansichten hinzugefügt hat:

Über die Symbole oben im Bereich Dateibrowser können Sie alle Ordner minimieren, Dateien und Ordner verschieben und löschen, nach einer Projektdatei suchen oder neue Ordner und neue Dateien erstellen.

IDE-Seitenleiste minimieren

Sie können den IDE-Dateibrowser mit der Tastenkombination Befehlstaste + B (Mac) oder Strg + B (Windows) oder durch Auswählen des Dateibrowsersymbols ein- oder ausblenden:

Dateien und Ordner verwalten

Für jede Datei oder jeden Ordner in der linken Seitenleiste gibt es ein Menü mit den verfügbaren Aktionen für das jeweilige Element. Klicken Sie auf das Dreipunkt-Menü Ordneraktionen (für Ordner) oder das Menü Dateiaktionen (für Dateien) rechts neben dem Dateinamen, um das Menü zu öffnen. Bei einem Element, das einen langen Namen hat oder in mehreren Ordnern verschachtelt ist, können Sie auf das Menü zugreifen, indem Sie im linken Steuerfeld scrollen.

Mit dem Dateibrowser können Sie Ordner und Dateien erstellen, hochladen sowie Dateien und Ordner löschen und verschieben. Weitere Informationen finden Sie auf der Dokumentationsseite LookML-Dateien und -Ordner verwalten.

Wenn Sie Ihre LookML-Dateien mit Ordnern organisieren, müssen Sie Ihre Änderungen übernehmen und für die Produktion bereitstellen, damit sie für andere Looker-Entwickler sichtbar sind. Dies ist genauso wie jede Änderung, die Sie an Ihrem LookML-Projekt vornehmen.

Ordner mit importierten Projekten

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. Wählen Sie eine importierte Projektdatei aus der Dateiliste im imported_projects aus, um den Inhalt dieser Datei anzusehen.

Da sie nicht bearbeitet werden können, sind importierte Projektdateien nicht sichtbar, wenn Sie Dateien mit Bulk-Bearbeitungen in der IDE zum Verschieben oder Löschen dieser Dateien ausführen.

Vorhandenes Projekt mit IDE-Ordnern organisieren

Wenn Ihr Projekt zuvor die alte Flatfile-Struktur hatte oder wenn 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 Updates für die Produktion bereitgestellt haben. Wenn ein Entwickler Änderungen rückgängig gemacht hat, spiegeln seine Zweige die Dateistruktur wider, die beim letzten Abruf aus der Produktion vorhanden war. Wenn das Projekt zu diesem Zeitpunkt eine flache Dateistruktur hatte, wird die Entwicklerversion der Datei am ursprünglichen Speicherort in die Produktion übertragen, sodass Sie am Ende zwei Kopien der Datei erhalten. Wenn ein Entwickler während der Migration von Ordnern Änderungen rückgängig gemacht hat, kommt es außerdem nach der Migration zu einem Zusammenführungskonflikt.
• Führen Sie bei allen Entwicklern ein vorübergehendes Einfrieren des Codes ein, bis das Projekt vollständig in die neue Verzeichnisstruktur migriert wurde.
• Beauftragen Sie einen einzelnen Entwickler, die Dateien zu verschieben. Im folgenden Verfahren 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 Zusammenführungskonflikte zu vermeiden. Wenn bei der Zusammenführung Probleme auftreten, finden Sie auf der Dokumentationsseite Versionsverwaltung und Bereitstellung Informationen zum Beheben dieser Konflikte.

Hinweis: Wenn Sie eine Datei in Git verschieben, löschen Sie damit die Datei und erstellen eine neue Datei mit einem neuen Dateipfad. Dies 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 die Datei am ursprünglichen Speicherort über die Git-Oberfläche auf und rufen Sie von dort aus den Git-Verlauf auf.

Sobald alle Ihre Entwickler ihre Änderungen übertragen und übernommen und die gesamte Arbeit am Projekt pausiert haben, können Sie das Projekt in die neue Verzeichnisstruktur migrieren.

Weisen Sie einen einzelnen Entwickler für alle folgenden Schritte zu:

1. Prüfen Sie, ob alle Updates in allen Entwicklungs-Branches 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 vornehmen.
3. Aus der Produktion abrufen.
4. Erstellen Sie die Ordner des Projekts.
5. Verschieben Sie die Projektdateien in die Ordner, entweder jeweils eine Datei oder per Bulk-Bearbeitung.
6. Validieren Sie den LookML-Code des Projekts. Es wird erwartet, dass Sie mehrere LookML-Fehler und -Warnungen erhalten, da die Anweisungen include und map_layer Verweise auf Dateispeicherorte verwenden, die bei diesem Vorgang wahrscheinlich verschoben wurden.

7. Aktualisieren Sie alle include- und map_layer-Anweisungen in Ihrem Projekt, damit sie dem neuen Pfad der Datei entsprechen. Darüber hinaus 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 zur Verwendung von include mit IDE-Ordnern und zur Verwendung von map_layer mit IDE-Ordnern.

   Tipp: Sie können Platzhalter verwenden, um eine temporäre Korrektur von LookML-Validierungswarnungen und -Fehlern zu erstellen, die aus include-Anweisungen resultieren. Wenn Sie zum Beispiel Ansichtsdateien verwenden, können Sie include: "/**/*.view" angeben, um alle Dateien in allen Projektordnern einzuschließen. Dadurch werden LookML-Validierungsprobleme während der Entwicklung vermieden. Auf lange Sicht ist dies jedoch keine empfohlene Lösung, da sich mehr Dateien als erforderlich auf die Leistung auswirken.

8. Führen Sie ein Commit für die Änderungen durch.

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

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