Perlu diperhatikan bahwa Anda sedang melihat dokumentasi Looker. Untuk melihat dokumentasi Looker Studio, buka https://support.google.com/looker-studio.

Halaman ini diterjemahkan oleh Cloud Translation API.

LookML Baru — Cara mengonversi project LookML YAML

Looker 4.0 memperkenalkan sintaksis LookML baru yang meningkatkan LookML gaya YAML asli dengan sintaksis yang sudah dikenal tetapi lebih mudah dan IDE yang kaya dan membantu untuk mempermudah pengembangan LookML. Mulai Looker 4.4 dan seterusnya, semua project LookML baru harus dibuat di LookML baru; namun, beberapa project yang dibuat sebelum konversi mungkin masih dimodelkan dalam LookML YAML (lama).

Looker menyediakan cara otomatis untuk mengonversi project LookML YAML menjadi LookML baru. Halaman ini menjelaskan cara melakukan proses tersebut. Setiap project LookML perlu dikonversi satu per satu, dan developer harus menyiapkan serta mengoordinasikan upaya, jadi pastikan untuk membaca halaman ini hingga selesai sebelum mengonversi project.

Bersiap untuk mengonversi

Tugas mengonversi project LookML YAML ke LookML baru hanya boleh dilakukan oleh satu developer LookML. Konversi terjadi dalam Mode Pengembangan developer tersebut, dan perubahan tersebut kemudian di-commit dan di-deploy seperti perubahan LookML biasa.

Meskipun demikian, proses ini memerlukan kerja sama semua developer LookML. Karena konversi pada dasarnya mengubah setiap baris LookML, penting untuk memastikan bahwa developer LookML lainnya telah melakukan commit dan men-deploy semua perubahan mereka ke project sebelum proses konversi dimulai. Jika tidak, beberapa konflik penggabungan Git yang sangat buruk dapat terjadi.

Meskipun proses konversi otomatis, LookML baru jauh lebih menyeluruh dalam pemeriksaan error dibandingkan LookML YAML. Artinya, setelah konversi, error yang sebelumnya tidak muncul mungkin akan muncul. Dengan mengatasi error ini, kualitas project akan meningkat. Jumlah error akan bervariasi dari project ke project, yang berarti bahwa memperbaikinya dapat memerlukan waktu dari beberapa menit hingga beberapa jam. Apa pun yang terjadi, pengembangan pada project harus tetap dijeda oleh semua developer LookML hingga error diperbaiki.

Menemukan project YAML di instance Looker

Untuk melihat project YAML di instance Looker Anda:

Dari menu Develop, pilih opsi Manage LookML Projects atau Projects (opsi ini sedikit berbeda bergantung pada tempat Anda mengakses menu Develop).
Di halaman LookML Projects, cari label YAML LookML di baris tabel project:

TIP: Anda dapat memilih nama project dalam tabel untuk membuka LookML project.

Berkoordinasi dengan developer sebelum melakukan konversi

Untuk mempersiapkan konversi ke LookML baru:

Pilih satu developer LookML untuk menjalankan proses konversi.
Pastikan project bebas error dengan menjalankan LookML Validator. Perbaiki semua error, lalu commit dan deploy perubahan sebelum melanjutkan ke langkah berikutnya.
Tentukan waktu untuk melakukan konversi.
Beri tahu semua developer LookML lainnya bahwa mereka harus melakukan commit dan men-deploy perubahan yang sedang mereka kerjakan pada waktu yang ditentukan. Artinya, semua salinan Mode Pengembangan project harus dalam status Git Terbaru dengan Produksi.
Beri tahu semua developer LookML lainnya bahwa mereka tidak boleh membuat, melakukan commit, atau men-deploy perubahan apa pun hingga konversi selesai.

Mengonversi ke LookML Baru

Untuk mengonversi ke LookML baru, jalankan pengonversi:

Masuk ke Mode Pengembangan.
Buka project yang akan dikonversi.
Pastikan status Git di sudut kiri atas menunjukkan Up to Date dengan Produksi.
Jalankan LookML Validator untuk memastikan tidak ada error dalam project — hasilnya akan berupa Tidak Ada Masalah LookML. (Untuk menjalankan LookML Validator, pilih tombol Validate LookML di kanan atas Looker IDE; atau pilih ikon Project Health di bagian atas IDE untuk membuka panel Project Health, lalu pilih Validate LookML.)
Untuk mengonversi project dari LookML YAML ke LookML baru:
1. Pilih ikon Tindakan Git dari sidebar navigasi IDE Looker.
  - Atau, pilih ikon Project Health dari bagian atas IDE:
2. Pilih opsi Convert Project to New LookML dari panel Git Actions atau dari bagian bawah panel Project Health.
3. Pilih tombol Konversikan ke LookML Baru di dialog konfirmasi.

Memvalidasi LookML baru

Setelah konverter selesai berjalan, IDE akan menunjukkan bahwa file Anda telah berubah dengan titik di samping setiap nama file:

Untuk memvalidasi LookML baru:

Pilih tombol Validasi LookML untuk menjalankan LookML Validator. Jika tidak ada error, Anda dapat langsung melanjutkan ke bagian Mem-commit dan men-deploy LookML baru di halaman ini.
Anda mungkin melihat error yang sebelumnya tidak ada. Seperti yang telah disebutkan sebelumnya, LookML baru lebih menyeluruh dalam memeriksa error daripada LookML YAML. Periksa dan perbaiki error. Jika Anda mengalami kesulitan dalam mengatasinya, lihat bagian Mengatasi error di akhir halaman ini.

Melakukan commit dan men-deploy LookML baru

Pada tahap ini, commit dan deploy seperti yang Anda lakukan dengan perubahan LookML biasa. Perhatikan: commit ini akan memicu pembuatan ulang tabel turunan persisten (PDT) Anda. Setelah commit di-deploy, beri tahu semua developer LookML lainnya bahwa konversi telah dilakukan dan kueri yang mengandalkan PDT mungkin memerlukan waktu sedikit lebih lama dari biasanya untuk dijalankan, setidaknya hingga semuanya di-build ulang. Developer dapat mengambil dari produksi dalam Mode Pengembangan untuk menerapkan perubahan, lalu melanjutkan pengembangan — kini dengan sintaksis LookML yang ditingkatkan dan lebih intuitif, serta IDE yang jauh lebih bermanfaat dan canggih.

Mengatasi error

Sebagai akibat dari validasi model LookML baru yang lebih menyeluruh, Anda mungkin melihat error setelah melakukan konversi yang sebelumnya tidak muncul. Selain itu, pemeriksaan error ad hoc LookML baru memerlukan sedikit lebih banyak informasi dalam beberapa kasus; pengonversi mencoba mencari tahu hal ini untuk Anda, tetapi dalam beberapa kasus, Anda mungkin perlu menambahkan baris include tambahan dalam satu atau dua file tampilan.

Referensi kolom tidak valid

Dalam beberapa konteks, LookML YAML (lama) tidak memastikan bahwa kolom atau set yang Anda referensikan benar-benar ditentukan di suatu tempat dalam model. Tempat yang paling mungkin menampilkannya adalah dalam daftar dan set kolom perincian.

Misalnya, jika LookML lama Anda menyertakan drill_fields: [id, name, email], tetapi pada suatu saat dalam pengembangan model, Anda menghapus kolom name dan menggantinya dengan kolom first_name dan last_name, LookML YAML tidak akan memperingatkan Anda bahwa Anda mereferensikan kolom (name) dalam daftar kolom perincian ini yang tidak ada. Hal ini juga dapat terjadi jika Anda mereferensikan kolom dalam grup dimensi dan LookML YAML Anda tidak menentukan kolom seperti yang dilakukan LookML baru.

Di sisi lain, LookML baru akan menampilkan jenis error ini. Jadi, setelah mengonversi project dan menjalankan LookML Validator, Anda mungkin melihat error tentang referensi kolom tidak valid yang belum pernah Anda lihat sebelumnya. Memperbaiki error ini akan meningkatkan kualitas model Anda secara keseluruhan.

Tidak ada penyertaan dalam file tampilan

Dalam beberapa kasus, pemeriksaan error ad hoc LookML baru memerlukan sedikit lebih banyak konteks daripada yang diperlukan di LookML YAML. Secara khusus, Anda mungkin perlu menempatkan baris include di beberapa file tampilan, biasanya saat satu tampilan memperluas tampilan lainnya.

Jika tidak ada ambiguitas tentang file yang perlu disertakan dalam tampilan, pengonversi akan otomatis menambahkan deklarasi include yang sesuai dalam file tampilan LookML baru, dan Anda tidak akan melihat error apa pun.

Namun, dalam beberapa kasus (seperti dengan project yang berisi beberapa model), mungkin ada dua atau beberapa tampilan dengan nama yang sama yang dideklarasikan dalam file tampilan terpisah. Konverter tidak akan dapat menentukan mana yang benar untuk disertakan, sehingga akan menambahkan komentar di bagian atas file LookML baru untuk menunjukkan bahwa hanya salah satu tampilan tersebut yang harus disertakan. Atasi error yang dihasilkan dengan membuka file tampilan dan menghapus komentar pada saran yang benar.

Penjelajahan `extension_required` yang Terdampar

Seperti masalah referensi kolom yang tidak valid yang dijelaskan sebelumnya, di LookML baru, LookML Validator akan memberi tahu Anda tentang Jelajah yang dideklarasikan dengan extension: required, tetapi tidak benar-benar diperluas. Untuk mengatasi error ini, hubungkan kembali eksplorasi ini ke objek yang diperluas atau, jika tidak digunakan, hapus.

Kontrol versi

Karena proses konversi LookML mengganti file tampilan dan model .lookml dengan versi .lkml, jika satu atau beberapa developer melakukan commit ke project Anda selama konversi, Anda akan berada di tengah konflik penggabungan. Oleh karena itu, sangat penting untuk hanya satu developer yang menjalankan pengonversi, dan mereka harus berkoordinasi untuk memastikan bahwa salinan Mode Pengembangan semua orang bersih dan terbaru sebelum memulai proses konversi.

Untuk menghindari masalah kontrol versi, harus ada pembekuan kode selama konversi. Developer lain tidak boleh memeriksa perubahan selama waktu yang diblokir untuk konversi.

Jika developer yang menjalankan konversi mengalami masalah selama proses konversi, tetapi sebelum melakukan perubahan dan melakukan push ke produksi, mereka mungkin merasa perlu untuk kembali ke produksi. Opsi ini dari drop-down (digambarkan di bagian Run the converter di halaman ini) akan mengurungkan konversi, sehingga developer dapat memulai ulang prosesnya.