Ekstensi Looker untuk VS Code menggunakan model pengembangan lokal terlebih dahulu. Model ini mempertahankan hubungan tiga arah antara sistem file lokal Anda, Mode Pengembangan instance Looker, dan repositori Git jarak jauh.
Panduan ini menjelaskan cara ekstensi menyinkronkan file dan pengaruh operasi Git lokal terhadap project Looker Anda.
Mekanisme sinkronisasi
Ekstensi ini otomatis mengelola sinkronisasi konten file antara IDE lokal dan server Looker.
Membuka file (baca saat dibuka)
Saat Anda membuka file .lkml di IDE lokal, ekstensi akan otomatis mengambil versi terbaru file tersebut dari cabang yang Anda checkout di Mode Pengembangan instance Looker. Hal ini memastikan Anda selalu menggunakan versi kode terbaru.
Menyimpan file (tulis saat disimpan)
Saat Anda menyimpan file secara lokal (Command-S di Mac atau Ctrl+S di Windows/Linux), ekstensi akan langsung mengirimkan perubahan lokal Anda ke server Looker. Perubahan ini kemudian akan terlihat di Looker IDE berbasis browser saat Anda berada dalam Mode Pengembangan.
Menangani konflik sinkronisasi
Konflik dapat terjadi jika file diedit di Looker IDE berbasis browser saat file tersebut juga dibuka di VS Code.
Secara default, ekstensi akan mengganti versi di server Looker dengan versi VS Code lokal Anda.
Namun, jika Anda telah mengaktifkan setelan looker.askBeforeOverwritingRemote, VS Code akan menampilkan peringatan saat Anda mencoba menyimpan file yang telah diubah di server. Anda dapat memilih untuk melakukan salah satu tindakan berikut:
- Keep Local: Mengganti versi di server Looker dengan versi VS Code lokal Anda.
- Pull Remote: Mengganti file lokal Anda dengan versi dari server Looker.
Setelan looker.askBeforeOverwritingRemote dinonaktifkan secara default.
Operasi Git lokal
Ekstensi ini menyinkronkan konten file, tetapi Anda harus mengelola repositori Git menggunakan perintah Git standar di terminal lokal atau tab Kontrol Sumber IDE lokal.
Mengelola cabang
Saat Anda beralih cabang secara lokal menggunakan git checkout, ekstensi akan mendeteksi perubahan tersebut dan otomatis mengalihkan sesi Anda di server Looker ke cabang yang cocok.
Status Git di Looker
Saat Anda menyimpan perubahan file, perubahan tersebut akan disinkronkan ke instance Looker dan muncul sebagai belum di-commit di Looker IDE berbasis browser. Jika Anda melakukan commit perubahan ini menggunakan Git di lingkungan lokal, perubahan tersebut akan terus muncul sebagai belum di-commit di Looker IDE hingga Anda mengirimkannya ke repositori jarak jauh.
Saat Anda menggunakan git push, instance Looker akan menarik perubahan yang di-commit dari repositori jarak jauh. Setelah instance Looker menarik dari jarak jauh, perubahan yang telah Anda commit dan kirim tidak akan lagi muncul sebagai belum di-commit di Looker IDE. Hanya file yang disimpan secara lokal, tetapi belum di-commit dan dikirim yang akan muncul sebagai belum di-commit.
Memvalidasi LookML
Ekstensi ini otomatis menjalankan Validator LookML Looker setiap kali Anda menyimpan perubahan. Error sintaksis dan model yang ditampilkan oleh Validator akan muncul secara inline dalam file Anda di dalam IDE lokal. Jika mau, Anda juga dapat menjalankan Validator LookML secara manual tanpa menyimpan file menggunakan perintah Palet Perintah Looker: Validate LookML.