Die Looker-Erweiterung für VS Code verwendet ein Local-First-Entwicklungsmodell. Dieses Modell unterhält eine Dreierbeziehung zwischen Ihrem lokalen Dateisystem, dem Entwicklungsmodus Ihrer Looker-Instanz und Ihrem Remote-Git-Repository.
In dieser Anleitung wird erläutert, wie die Erweiterung Dateien synchronisiert und wie sich lokale Git-Vorgänge auf Ihr Looker-Projekt auswirken.
Synchronisierungsmechanismus
Die Erweiterung verwaltet automatisch die Synchronisierung von Dateiinhalten zwischen Ihrer lokalen IDE und dem Looker-Server.
Dateien öffnen (read-on-open)
Wenn Sie eine .lkml-Datei in Ihrer lokalen IDE öffnen, ruft die Erweiterung automatisch die aktuelle Version dieser Datei aus Ihrem ausgecheckten Zweig im Entwicklungsmodus Ihrer Looker-Instanz ab. So arbeiten Sie immer mit der neuesten Version des Codes.
Dateien speichern (write-on-save)
Wenn Sie eine Datei lokal speichern (Command-S auf dem Mac oder Strg+S unter Windows/Linux), überträgt die Erweiterung Ihre lokalen Änderungen sofort an den Looker-Server. Diese Änderungen sind dann in der browserbasierten Looker IDE sichtbar, wenn Sie sich im Entwicklungsmodus befinden.
Synchronisierungskonflikte behandeln
Wenn eine Datei in der browserbasierten Looker IDE bearbeitet wird, während sie auch in VS Code geöffnet ist, kann ein Konflikt auftreten.
Standardmäßig überschreibt die Erweiterung die Version auf dem Looker-Server mit Ihrer lokalen VS Code-Version.
Wenn Sie jedoch die Einstellung looker.askBeforeOverwritingRemote aktiviert haben, zeigt VS Code eine Warnung an, wenn Sie versuchen, eine Datei zu speichern, die auf dem Server geändert wurde. Sie haben folgende Möglichkeiten:
- Lokal behalten: Überschreibt die Version auf dem Looker-Server mit Ihrer lokalen VS Code-Version.
- Remote abrufen: Überschreibt Ihre lokale Datei mit der Version vom Looker-Server.
Die Einstellung looker.askBeforeOverwritingRemote ist standardmäßig deaktiviert.
Lokale Git-Vorgänge
Die Erweiterung synchronisiert Dateiinhalte. Sie sollten Ihr Git-Repository jedoch mit Standard-Git-Befehlen in Ihrem lokalen Terminal oder auf dem Tab „Source Control“ (Quellcodeverwaltung) der lokalen IDE verwalten.
Zweige verwalten
Wenn Sie lokal mit git checkout Zweige wechseln, erkennt die Erweiterung die Änderung und wechselt Ihre Sitzung auf dem Looker-Server automatisch zum entsprechenden Zweig.
Git-Status in Looker
Wenn Sie Änderungen an Dateien speichern, werden sie mit Ihrer Looker-Instanz synchronisiert und in der browserbasierten Looker IDE als nicht übergeben angezeigt. Wenn Sie diese Änderungen mit Git in Ihrer lokalen Umgebung übergeben, werden sie in der Looker IDE weiterhin als nicht übergeben angezeigt, bis Sie sie an Ihr Remote-Repository übertragen.
Wenn Sie git push verwenden, ruft Ihre Looker-Instanz die übergebenen Änderungen aus Ihrem Remote-Repository ab. Nachdem Ihre Looker-Instanz die Änderungen aus dem Remote-Repository abgerufen hat, werden die von Ihnen übergebenen und übertragenen Änderungen in der Looker IDE nicht mehr als nicht übergeben angezeigt. Nur Dateien, die lokal gespeichert, aber noch nicht übergeben und übertragen wurden, werden als nicht übergeben angezeigt.
LookML validieren
Die Erweiterung führt jedes Mal, wenn Sie eine Änderung speichern, automatisch die LookML-Validierung von Looker aus. Alle Syntax- und Modellfehler, die vom Validator zurückgegeben werden, werden inline in Ihren Dateien in Ihrer lokalen IDE angezeigt. Sie können die LookML-Validierung auch manuell ausführen, ohne Dateien zu speichern. Verwenden Sie dazu den Befehl Looker: Validate LookML (Looker: LookML validieren) in der Befehlspalette.