Ekstensi Looker untuk VS Code menggunakan model pengembangan yang mengutamakan lokalitas. Model ini mempertahankan hubungan tiga arah antara sistem file lokal Anda, Mode Pengembangan instance Looker Anda, dan repositori Git jarak jauh Anda.
Panduan ini menjelaskan cara ekstensi menyinkronkan file dan pengaruh operasi Git lokal terhadap project Looker Anda.
Mekanisme sinkronisasi
Ekstensi ini secara 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 di-checkout di Mode Pengembangan instance Looker Anda. Hal ini memastikan Anda selalu mengerjakan versi kode terbaru.
Menyimpan file (tulis saat menyimpan)
Saat Anda menyimpan file secara lokal (Command-S di Mac atau Ctrl+S di Windows/Linux), ekstensi akan segera 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
Jika file diedit di Looker IDE berbasis browser saat juga dibuka di VS Code, konflik dapat terjadi.
Secara default, ekstensi akan menggantikan 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 dimodifikasi di server. Anda dapat memilih untuk melakukan salah satu tindakan berikut:
- Keep Local: Menimpa versi di server Looker dengan versi VS Code lokal Anda.
- Tarik Jarak Jauh: Menimpa 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 mengganti cabang secara lokal menggunakan git checkout, ekstensi akan mendeteksi perubahan dan otomatis mengganti 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 Anda dan muncul sebagai tidak 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 IDE Looker hingga Anda mengirimkannya ke repositori jarak jauh.
Saat Anda menggunakan git push, instance Looker akan menarik perubahan yang di-commit dari repositori jarak jauh Anda. Setelah instance Looker Anda menarik dari jarak jauh, perubahan yang telah Anda lakukan dan kirim tidak akan lagi muncul sebagai belum dilakukan di IDE Looker. Hanya file yang disimpan secara lokal, tetapi belum di-commit dan di-push yang akan muncul sebagai belum di-commit.
Memvalidasi LookML
Ekstensi ini otomatis menjalankan Validator LookML Looker setiap kali Anda menyimpan perubahan. Semua error sintaksis dan model yang ditampilkan oleh Validator akan muncul secara inline dalam file Anda di IDE lokal. Jika mau, Anda juga dapat menjalankan Validator LookML secara manual tanpa menyimpan file menggunakan perintah Palet Perintah Looker: Validate LookML.