Die Looker-Erweiterung für VS Code verwendet ein lokales Entwicklungsmodell. Dieses Modell basiert auf einer Dreiecksbeziehung zwischen Ihrem lokalen Dateisystem, dem Entwicklermodus 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 übernimmt 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 dem ausgecheckten Branch im Entwicklermodus Ihrer Looker-Instanz ab. So arbeiten Sie immer mit der aktuellen Version des Codes.
Dateien speichern (Write-on-Save)
Wenn Sie eine Datei lokal speichern (Befehl + S auf dem Mac oder Strg + S unter Windows/Linux), werden Ihre lokalen Änderungen sofort an den Looker-Server übertragen. Diese Änderungen sind dann in der browserbasierten Looker IDE sichtbar, wenn Sie sich im Entwicklungsmodus befinden.
Synchronisierungskonflikte beheben
Wenn eine Datei in der browserbasierten Looker IDE bearbeitet wird, während sie auch in VS Code geöffnet ist, kann es zu einem Konflikt kommen.
Standardmäßig wird die Version auf dem Looker-Server durch Ihre lokale VS Code-Version überschrieben.
Wenn Sie die Einstellung looker.askBeforeOverwritingRemote aktiviert haben, wird in VS Code jedoch eine Warnung angezeigt, wenn Sie versuchen, eine Datei zu speichern, die auf dem Server geändert wurde. Sie haben folgende Möglichkeiten:
- Keep Local (Lokal beibehalten): Die Version auf dem Looker-Server wird mit Ihrer lokalen VS Code-Version überschrieben.
- Pull Remote: Ihre lokale Datei wird mit der Version vom Looker-Server überschrieben.
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 den Zweig 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 committen, werden sie in der Looker-IDE weiterhin als nicht committet angezeigt, bis Sie sie in Ihr Remote-Repository übertragen.
Wenn Sie git push verwenden, werden die übernommenen Änderungen aus Ihrem Remote-Repository in Ihre Looker-Instanz übertragen. Nachdem Ihre Looker-Instanz Daten von einem Remote-Repository abgerufen hat, werden Änderungen, die Sie committet und gepusht haben, nicht mehr als nicht committet in der Looker-IDE angezeigt. Nur Dateien, die lokal gespeichert, aber noch nicht committet und gepusht wurden, werden als „nicht committet“ angezeigt.
LookML validieren
Die Erweiterung führt die Looker-LookML-Validierung automatisch aus, wenn Sie eine Änderung speichern. Alle Syntax- und Modellfehler, die von der Validierung zurückgegeben werden, werden inline in Ihren Dateien in Ihrer lokalen IDE angezeigt. Wenn Sie möchten, können Sie die LookML-Validierung auch manuell ausführen, ohne Dateien zu speichern. Verwenden Sie dazu den Befehl Looker: Validate LookML in der Befehlspalette.