Ringkasan Looker IDE

IDE Looker (integrated development environment) menyediakan akses ke file project LookML dan setelan untuk project LookML Anda.

Mengakses Looker IDE

Untuk melihat project LookML, Anda harus memiliki izin develop untuk minimal satu model dalam project. Anda dapat mengakses IDE Looker melalui panel Develop di menu navigasi utama Looker:

  1. Pilih Develop di panel navigasi untuk membuka panel Develop.
  2. Di panel Develop, pilih nama project yang ingin Anda akses.

Looker akan membuka IDE ke project LookML yang Anda pilih.

Atau, Anda dapat membuka IDE ke objek LookML tertentu dari Jelajah atau dari browser objek. Lihat Mengakses file project untuk mengetahui detail dan opsi lainnya.

Elemen Looker IDE

IDE Looker memiliki elemen berikut:

  1. Banner Mode Pengembangan: Banner ini menunjukkan bahwa Anda berada dalam Mode Pengembangan, tempat Anda dapat melakukan perubahan pada file LookML dan melihat pratinjau pengaruhnya terhadap konten di instance Anda. Anda dapat mengklik link Keluar dari Mode Pengembangan di banner untuk beralih ke Mode Produksi.
  2. Menu navigasi IDE: Gunakan menu navigasi untuk mengakses berbagai fitur Looker IDE. Beberapa fitur hanya tersedia saat Anda berada dalam Mode Pengembangan. Setelah memilih fitur dari menu navigasi IDE, Anda dapat memilih item menu navigasi untuk kedua kalinya guna menciutkan panel fitur. Panel navigasi IDE memberikan akses ke fitur IDE berikut:
    • File Browser: Membuka file browser, yang memberi Anda akses ke file dan folder dalam project LookML.
    • Object Browser: Membuka object browser, yang menampilkan objek LookML dalam project Anda dan menunjukkan hubungan hierarkis antar-objek.
    • Cari dan Ganti: Menampilkan halaman Cari & Ganti di Project, yang dapat Anda gunakan untuk menelusuri teks di semua file project, lalu mengganti semua instance atau instance yang dipilih dalam operasi massal.
    • Tindakan Git: (Hanya terlihat dalam Mode Pengembangan) Menampilkan cabang Git di project Anda dan menampilkan perintah Git yang tersedia untuk cabang Git project Anda. Lihat halaman dokumentasi Menggunakan kontrol versi dan men-deploy untuk mengetahui informasi tentang cara menggunakan Git dengan project LookML Anda.
    • Setelan: (Hanya terlihat dalam Mode Pengembangan) Menampilkan halaman setelan project untuk project Anda tempat Anda dapat mengonfigurasi opsi kontrol versi project, kredensial autentikasi untuk project yang diimpor, cabang Git yang digunakan oleh project Anda, dan setelan IDE.
    • Deploy: (Hanya terlihat dalam Mode Pengembangan) Untuk project yang disiapkan dengan mode deployment lanjutan, membuka Pengelola Deployment tempat developer yang memiliki izin deploy dapat men-deploy commit atau tag ke lingkungan produksi Looker mereka.
  3. Panel fitur: Memberikan navigasi untuk file dan objek LookML untuk browser file dan browser objek, parameter penelusuran untuk fungsi temukan dan ganti, perintah Git yang tersedia untuk panel Tindakan Git, dan tab untuk mengakses berbagai setelan untuk panel setelan project.
  4. Panel editor IDE: Editor untuk file LookML. Editor ditampilkan saat File Browser atau Object Browser dipilih di menu navigasi IDE. Lihat Fitur pengeditan IDE Looker untuk mengetahui informasi selengkapnya tentang editor.
  5. Pemilih panel samping: Klik opsi untuk membuka fitur panel samping IDE:
    • Project Health: Membuka panel Project Health.
    • Bantuan Cepat: Membuka panel Bantuan Cepat, yang menyertakan tab untuk mengakses panel Metadata.
    • Bantu tulis: (Untuk instance Looker (Google Cloud core) dengan Gemini diaktifkan) Membuka panel Bantu tulis. Klik opsi pemilih panel samping untuk kedua kalinya guna menyembunyikan panel samping IDE.
  6. Panel samping IDE: Menampilkan fitur panel samping yang dipilih:
  7. Tombol Git: Bergantung pada status project, tombol ini menampilkan tindakan berikutnya yang harus Anda lakukan untuk mem-build project ke produksi, seperti Validate LookML, Push Branch to Remote, atau Commit. Klik tombol untuk melakukan tindakan. Lihat referensi perintah Git untuk mengetahui kemungkinan perintah yang dapat ditampilkan dan dieksekusi oleh tombol.

Menyiapkan Looker IDE

Anda dapat menyesuaikan Looker IDE dengan cara berikut:

Mode editor teks

IDE Looker mendukung tiga mode editor teks:

Untuk mengubah mode editor teks, ikuti langkah-langkah berikut:

  1. Pilih ikon Setelan dari panel navigasi kiri di Looker IDE.
  2. Pilih tab Editor dari Setelan IDE.
  3. Gunakan menu drop-down Mode Editor Teks untuk memilih opsi Anda.

Setelah Anda memilih opsi dari menu drop-down, Looker IDE akan langsung diperbarui untuk menggunakan mode editor teks yang dipilih.

Mode penggabungan baris

Secara default, IDE Looker diaktifkan untuk penggabungan baris.

Untuk mengaktifkan atau menonaktifkan penggabungan baris:

  1. Pilih ikon Setelan dari panel navigasi kiri di Looker IDE.
  2. Pilih tab Editor dari Setelan IDE.
  3. Gunakan tombol Mode perataan baris untuk mengaktifkan atau menonaktifkan perataan baris di IDE.

Setelah Anda mengubah tombol, pembaruan akan diterapkan ke IDE Looker.

Mengubah ukuran panel samping IDE

Anda dapat mengubah lebar panel di IDE, baik panel fitur (yang berisi panel File Browser, Object Browser, dan Git Actions) maupun panel samping (yang berisi panel Project Health, Quick Help, dan Metadata).

Untuk mengubah ukuran panel IDE, tahan kursor di atas batas panel, lalu tarik untuk mengubah ukuran panel:

Jika Anda berada dalam Mode Pengembangan, IDE akan mempertahankan ukuran panel samping di seluruh login dan refresh.

Menciutkan panel samping IDE

Jika ingin memaksimalkan lebar panel editor IDE, Anda dapat menciutkan panel samping IDE:

  • Untuk menampilkan atau menyembunyikan panel fitur IDE, gunakan pintasan keyboard Command-B (Mac) atau Ctrl+B (Windows), atau klik ikon di menu navigasi IDE yang sudah dipilih.
  • Untuk menampilkan atau menyembunyikan panel samping IDE, klik ikon di pemilih panel samping yang sudah dipilih.

Fitur pengeditan Looker IDE

Bagian berikut menjelaskan beberapa fitur pengeditan Looker IDE yang dapat membantu Anda mengembangkan LookML:

Saran otomatis

Saat Anda mengetik, IDE akan menyarankan kemungkinan parameter dan nilai yang sensitif terhadap konteks yang Anda ketik. Misalnya, saran untuk parameter type dimensi hanya akan menyertakan opsi yang valid untuk parameter tersebut. Selain itu, kolom dalam parameter sql harus ditandai dengan ${...}, sehingga IDE menambahkan sintaksis tersebut saat menyarankan kolom.

Saran otomatis akan otomatis muncul di mana pun saran tersebut dapat ditampilkan. Untuk menutupnya, tekan tombol Esc di keyboard. Untuk melihatnya kapan saja, tekan Ctrl+Spasi (Windows) atau Control-Spasi (Mac).

Pemeriksaan error ad hoc

IDE mendeteksi error sintaksis saat Anda mengetik. X merah di gutter menunjukkan error sintaksis, yang digarisbawahi dengan warna merah. Saat Anda menahan kursor di atas X merah, deskripsi singkat masalah akan muncul. Misalnya, jika Anda salah mengetik avrage, bukan average, sebagai nilai parameter type untuk pengukuran, IDE akan menampilkan error Invalid value for "type":avrage.

Validator LookML masih diperlukan untuk melakukan validasi model penuh. Beberapa error, seperti referensi kolom yang tidak valid yang disebabkan oleh join yang tidak ada, memerlukan tampilan menyeluruh pada model sehingga hanya ditampilkan saat LookML Validator dijalankan.

Pemformatan otomatis

Saat berada dalam Mode Pengembangan, Anda dapat menggunakan pintasan keyboard format file untuk membuat indentasi file LookML secara otomatis. Indentasi menunjukkan hierarki parameter dan subparameter, sehingga LookML Anda lebih mudah dibaca dan dipahami.

Lipat

Panah kecil akan muncul di gutter di samping awal setiap parameter LookML tingkat atas dalam file. Memilih panah ini akan melipat atau membentangkan bagian LookML tersebut sehingga Anda dapat berfokus hanya pada bagian tertentu.

Menu Lihat tindakan file untuk file LookML juga menyediakan opsi Fold LookML dan Unfold LookML untuk meluaskan atau menciutkan semua bagian LookML hingga ke parameter tingkat atas dalam file saat ini.

Anda juga dapat menggunakan pintasan keyboard untuk melipat dan membentangkan LookML.

Memberi komentar

Anda dapat menambahkan komentar ke LookML untuk membuatnya lebih mudah dibaca. Untuk menambahkan satu komentar, gunakan karakter #:

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

Anda dapat mengomentari seluruh blok kode menggunakan pintasan keyboard dengan melakukan langkah-langkah berikut:

  1. Pilih baris yang ingin Anda komentari.
  2. Tekan Command + / (Mac) atau Ctrl + / (Windows).

IDE akan menambahkan karakter # ke setiap baris yang Anda pilih.

Memberikan komentar pada blok SQL

Jika Anda mengomentari baris yang sepenuhnya berada dalam blok kode SQL, tambahkan notasi komentar SQL secara manual.

Saat Anda menggunakan blok komentar SQL, bagian yang dikomentari akan tetap ditafsirkan sebagai kode LookML. Oleh karena itu, Anda akan melihat komentar dalam SQL yang dihasilkan LookML, tetapi komentar tersebut tidak akan memengaruhi hasil kueri.

Melihat penambahan, perubahan, dan penghapusan

Di IDE LookML, beberapa indikator selalu ditampilkan saat Anda berada dalam Mode Pengembangan dan memiliki perubahan yang belum di-commit.

  • Nama file ditampilkan dengan titik biru di sisi kiri jendela untuk menunjukkan bahwa file tersebut baru, diubah, atau diganti namanya.
  • Saat Anda membuka file baru atau yang diubah, nomor baris di dalam file akan ditandai dengan warna hijau untuk menampilkan baris baru atau yang diubah, dan garis merah horizontal menunjukkan baris yang dihapus.

Persistensi status IDE

Saat Anda berada dalam Mode Pengembangan, IDE Looker akan mempertahankan status IDE Anda di seluruh pembaruan dan login. Status IDE Anda mencakup hal berikut:

  • Item yang dipilih di menu navigasi IDE (seperti browser file, tindakan Git, browser objek, atau setelan project)
  • Membuka file LookML yang ditampilkan di browser file
  • Status item yang diluaskan atau diciutkan di file browser dan browser objek
  • Lebar panel samping IDE
  • Item yang dipilih di sidebar kanan IDE (seperti panel Bantuan Cepat, panel Metadata, dan panel Kesehatan Project)
  • Mode perataan baris editor

Untuk mereset IDE ke setelan default, pilih ikon Setelan dari panel navigasi kiri di IDE Looker, pilih tab Editor dari bagian Setelan IDE, lalu klik tombol Reset IDE Layout. IDE akan mempertahankan status Anda lagi saat Anda terus membuka file dan membuat pilihan.

Membuka objek atau file

Di Looker IDE, Anda dapat melakukan penelusuran cepat untuk membuka langsung objek LookML dan file project menggunakan fitur Lompat ke objek atau file. Klik ikon Lompat ke objek atau file dari browser file atau browser objek, atau gunakan pintasan keyboard Command-J (Mac) atau Ctrl+J (Windows).

Lihat halaman dokumentasi Mengakses file project LookML untuk mengetahui informasi selengkapnya.

Panel Bantuan Cepat

Pilih ikon Bantuan Cepat untuk membuka panel Bantuan Cepat, yang memberikan penjelasan dan opsi untuk lokasi saat ini dalam kode. Pilih nama parameter di sidebar untuk membuka halaman dokumentasi Looker untuk parameter tersebut.

Panel Bantu saya menulis kode

Jika memiliki instance Looker (inti Google Cloud) dengan Gemini diaktifkan, Anda dapat menggunakan Gemini di Looker untuk membantu menulis LookML:

IDE Looker dengan ikon kode Help me ditandai.

Lihat dokumentasi Menulis LookML dengan bantuan Gemini di Looker untuk mengetahui detailnya.

Menu opsi untuk file dan folder

Di browser file, setiap file atau folder di panel samping kiri memiliki menu yang menampilkan tindakan yang tersedia untuk item tersebut. Tahan kursor di atas file dan folder, lalu pilih menu Folder Options tiga titik (untuk folder) atau menu File Options (untuk file) untuk membuka menu. Untuk item yang memiliki nama panjang atau disusun bertingkat dalam beberapa folder, Anda dapat mengakses menu dengan men-scroll ke samping di panel browser file.

Dari menu opsi, Anda dapat membuat folder dan file, mengupload file, serta menghapus dan memindahkan file dan folder menggunakan browser file. Untuk informasi selengkapnya, lihat halaman dokumentasi Mengelola file dan folder LookML.

Saat mengatur file LookML dengan folder, Anda harus melakukan commit pada perubahan dan men-deploynya ke produksi sebelum developer Looker lain dapat melihatnya. Hal ini sama seperti perubahan apa pun yang Anda buat pada project LookML.

Menemukan dan mengganti teks dalam project

IDE Looker memiliki fungsi temukan dan ganti, yang dapat Anda gunakan untuk menelusuri teks di semua file project, lalu mengganti semua instance atau instance yang dipilih dalam operasi massal.

Untuk menggunakan fungsi temukan Looker IDE, ikuti langkah-langkah berikut:

  1. Buka panel penelusuran di IDE.
  2. Masukkan istilah di kolom Temukan.
  3. Secara opsional, Anda dapat memilih Case Sensitive untuk hanya menelusuri instance yang cocok dengan huruf besar/kecil yang Anda masukkan di kolom Find, atau Anda dapat memilih RegEX untuk melakukan penelusuran ekspresi reguler.
  4. Pilih Temukan.
  5. Atau, Anda dapat memilih nama file untuk membuka file tersebut di IDE.

Jika berada dalam Mode Pengembangan, Anda juga akan melihat kolom Ganti Dengan. Untuk mengganti teks dalam project, ikuti langkah-langkah berikut:

  1. Masukkan teks pengganti di kolom Ganti Dengan. Jika ingin menghapus teks di kolom Cari, Anda dapat mengosongkan kolom Ganti Dengan.

  2. Pilih Pilih & Ganti untuk melihat pratinjau cara teks akan diganti dalam project Anda.

  3. Hasilnya akan menampilkan semua instance di project Anda yang ditandai untuk diganti. Anda dapat menggunakan opsi berikut untuk menyesuaikan instance yang diganti:

    • Gunakan kotak centang di samping ringkasan hasil untuk memilih atau membatalkan pilihan semua instance di seluruh project Anda.
    • Gunakan kotak centang di samping satu instance untuk memilih atau membatalkan pilihan instance tersebut.

  4. Pilih tombol Replace Selected untuk menerapkan penggantian ke instance yang telah Anda pilih. IDE akan menampilkan perubahan yang dibuat.

Membuat dan menguji kolom baru

Sebagai contoh pengeditan LookML, kita akan menambahkan beberapa kolom, lalu mengujinya.

Membuat dimensi

Pertama, kita akan menambahkan dimensi baru ke tampilan users yang menentukan apakah pengguna berasal dari California atau New York. Dimensi ini akan menjadi type: yesno, yang berarti akan menampilkan Ya jika pengguna berasal dari California atau New York, dan Tidak jika tidak.

LookML untuk dimensi baru kita terlihat seperti ini:

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Tambahkan dimensi ini ke file tampilan user, lalu klik tombol Save Changes dalam file.

Lihat operator penggantian untuk mempelajari ${TABLE}.state lebih lanjut.

Membuat pengukuran

Selanjutnya, kita akan menambahkan ukuran baru ke tampilan user yang menghitung rata-rata usia pengguna. Pengukuran ini akan menjadi type: average dan digabungkan di seluruh kolom age.

LookML untuk ukuran baru ini terlihat seperti:

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Tambahkan ukuran ini ke file tampilan user, lalu klik tombol Save Changes dalam file.

Menguji kolom di Jelajahi

Anda dapat menguji dimensi dan pengukuran baru dengan membuat kueri. Setelah Anda menyimpan perubahan, kolom ini akan muncul di pemilih kolom di Jelajahi. Gunakan menu drop-down Lihat tindakan file di samping nama file tampilan untuk mengakses Jelajahi untuk tampilan saat ini. Menu drop-down Lihat tindakan file mencantumkan Jelajah yang didasarkan pada tampilan, termasuk Jelajah yang dihubungkan dengan tampilan. Misalnya, untuk mengakses Jelajahi untuk tampilan yang disebut users, Anda dapat memilih opsi Jelajahi Pengguna dari menu drop-down Lihat tindakan file.

Di Jelajah Pengguna, Anda dapat memilih kolom baru untuk menambahkannya ke kueri. Misalnya, Anda dapat membuat kueri dengan kedua kolom baru yang menampilkan usia rata-rata pengguna yang berasal dari California atau New York dan usia rata-rata pengguna yang tidak berasal dari kedua negara bagian tersebut:

Tabel data untuk sampel Jelajah Pengguna dengan kolom Pengguna dari CA atau NY (Ya/Tidak) dan Usia Rata-Rata Pengguna dipilih.