Mit dem IDE-Dateibrowser arbeiten

Am einfachsten greifen Sie über das Looker-Menü Entwickeln auf die Looker-IDE zu. 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 die Looker-Entwickler Ihre Projektdateien nicht in Ordnern organisiert haben, weist Ihr Projekt eine flache Dateistruktur auf. Die Dateien sind im Bereich Dateibrowser alphabetisch aufgelistet.

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

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

IDE-Seitenleiste minimieren

Sie können den IDE-Dateibrowser entweder mit der Tastenkombination Befehlstaste-B (Mac) oder Strg+B (Windows) oder durch Auswahl des Dateibrowser-Symbols ein- oder ausblenden:

Dateien und Ordner verwalten

Für jede Datei und jeden Ordner in der linken Seitenleiste gibt es ein Menü mit den verfügbaren Aktionen für das jeweilige Element. Wählen Sie rechts neben dem Dateinamen das Dreipunkt-Menü Ordneraktionen (Ordner) oder Dateiaktionen (für Dateien) aus, um das Menü zu öffnen. Bei Elementen mit einem langen Namen oder einem Element, das in mehreren Ordnern verschachtelt ist, können Sie durch Scrollen im linken Bereich auf das Menü zugreifen.

Mit dem Dateibrowser können Sie Ordner und Dateien erstellen, Dateien 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 per Commit speichern und für die Produktion bereitstellen, bevor andere Looker-Entwickler sie sehen können. Dies entspricht den Änderungen, 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 Liste der Dateien im imported_projects aus, um den Inhalt dieser Datei anzusehen.

Da sie nicht bearbeitet werden können, sind importierte Projektdateien nicht sichtbar, wenn Sie in der IDE Dateien gleichzeitig bearbeiten, um diese Dateien zu verschieben oder zu löschen.

Vorhandenes Projekt mit IDE-Ordnern organisieren

Wenn Ihr Projekt zuvor die Legacy-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, empfehlen wir dringend, die folgenden Vorbereitungen zu treffen:

• Planen Sie die Dateistruktur im Voraus mit allen Entwicklern.
• Sorgen Sie dafür, dass alle Looker-Entwickler alle Updates für die Produktion bereitgestellt haben. Wenn ein Entwickler die Bereitstellung von Änderungen zurückgenommen 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 zwei Kopien der Datei erhalten. Wenn ein Entwickler die Bereitstellung von Änderungen während der Migration in Ordner zurückgenommen hat, tritt außerdem ein Zusammenführungskonflikt auf, wenn er nach der Migration Daten aus der Produktion abruft.
• Erteilen Sie mit allen Entwicklern einen temporären Code-Freeze, bis das Projekt vollständig in die neue Verzeichnisstruktur migriert wurde.
• Beauftragen Sie einen einzelnen Entwickler, um die Dateien zu verschieben. Bei der folgenden Vorgehensweise 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 Konflikte auftreten, finden Sie auf der Dokumentationsseite Versionsverwaltung verwenden und bereitstellen Informationen zum Beheben dieser Konflikte.

Nachdem alle Ihre Entwickler ihre Änderungen per Push-Befehl übertragen und per Commit übertragen und alle Arbeiten an dem Projekt pausiert haben, können Sie das Projekt zu seiner neuen Verzeichnisstruktur migrieren.

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

1. Prüfen Sie, ob alle Updates in allen Entwicklungszweigen in der Produktion bereitgestellt wurden. Dazu gehören auch die Entwicklungszweige des Entwicklers, der die Migration in 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 eine Datei nach der anderen oder per Bulk-Bearbeitung in die Ordner.
6. Validieren Sie den LookML-Code des Projekts. Es ist zu erwarten, dass mehrere LookML-Fehler und -Warnungen angezeigt werden, da die Anweisungen include und map_layer Verweise auf Dateispeicherorte verwenden, die wahrscheinlich während dieses Verfahrens 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, da 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.

8. Übernehmen Sie die Änderungen.

9. Updates für die Produktion bereitstellen

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