Menulis LookML dengan bantuan Gemini

Halaman dokumentasi ini menjelaskan cara menggunakan bantuan Gemini untuk membuat dimensi, grup dimensi, dan ukuran, dalam project LookML. Menghasilkan saran kode LookML sebagai respons terhadap perintah tertulis adalah fitur Gemini di Looker yang tersedia di instance Looker (asli) dan Looker (Google Cloud core).

Gemini di Looker memberikan bantuan yang didukung teknologi AI generatif untuk membantu Anda menangani data.

Pelajari cara dan waktu Gemini untuk Google Cloud menggunakan data Anda.

Halaman ini ditujukan untuk developer Looker.

Sebelum memulai

Untuk menggunakan Gemini di Looker IDE, perhatikan persyaratan berikut:

  • Gemini di Looker harus diaktifkan untuk instance Looker Anda:
    • Untuk Looker (asli), instance harus menjalankan Looker 25.2 atau yang lebih baru, dan instance harus mengaktifkan setelan Gemini di Looker dan Asisten LookML di setelan Admin. Untuk mengetahui petunjuk pengaktifan mendetail, lihat halaman dokumentasi Setelan admin — Gemini di Looker.
    • Untuk Looker (Google Cloud core), instance harus diaktifkan untuk Gemini di Looker di Google Cloud konsol. Asisten LookML juga harus diaktifkan untuk instance Anda. Untuk mengetahui petunjuk pengaktifan mendetail, lihat halaman dokumentasi Mengelola Gemini di instance Looker (Google Cloud core).
  • Anda harus diberi peran Looker yang berisi izin develop untuk setidaknya satu model dalam project LookML.
  • Anda harus diberi peran yang berisi izin gemini_in_looker untuk setidaknya satu model dalam project LookML.

Menggunakan Gemini di Looker IDE

Untuk menggunakan Gemini guna membuat LookML di project Looker Anda, ikuti langkah-langkah berikut:

  1. Di instance Looker Anda, aktifkan Mode Pengembangan.
  2. Buka project Anda di Looker IDE.
  3. Gunakan browser file IDE untuk membuka file tampilan LookML tempat Anda ingin menyisipkan LookML.
  4. Pilih ikon Bantu saya membuat kode dari pemilih panel samping.

    IDE Looker dengan ikon Bantu saya membuat kode ditandai.

  5. Dengan panel Bantu saya membuat kode terbuka, klik untuk menempatkan kursor Anda pada baris di file tampilan LookML. Berdasarkan jenis file LookML dan tempat kursor Anda ditempatkan dalam file, Gemini akan memberikan opsi yang sesuai untuk memandu Anda, seperti Buat dimensi atau Buat ukuran.

  6. Pilih salah satu opsi berikut dari panel Bantu saya membuat kode:

    • Buat grup dimensi
    • Buat dimensi
    • Buat ukuran
    • Saran kode lainnya: Anda dapat menggunakan opsi saran kode lainnya jika ingin mencoba elemen LookML yang berbeda. Ingatlah bahwa Gemini adalah teknologi tahap awal, jadi validasi dan uji semua output sebelum men-deploy-nya.
  7. Di kolom teks panel Bantu saya membuat kode, gunakan bahasa percakapan untuk mendeskripsikan dimensi, grup dimensi, atau ukuran yang ingin Anda buat. Lihat bagian Tips menggunakan Gemini di Looker IDE dan Contoh perintah di halaman ini untuk mendapatkan panduan.

  8. Tekan Enter atau klik ikon Kirim untuk mengirim permintaan Anda ke Gemini. Gemini akan merespons dengan kode yang disarankan.

  9. Dengan kode yang disarankan, Anda dapat melakukan hal berikut:

    • Arahkan kursor ke tombol Sisipkan untuk melihat pratinjau LookML yang disarankan di file Anda. Anda dapat memindahkan kursor ke baris lain di file untuk melihat pratinjau di lokasi lain sebelum menyisipkan LookML di file.
    • Klik tombol Edit untuk mengubah LookML yang disarankan secara manual.
    • Klik tombol Sisipkan untuk menyisipkan LookML ke dalam file Anda di lokasi kursor Anda.
    • Berikan masukan tentang kode yang disarankan dengan memilih ikon suka (Respons ini bermanfaat) atau ikon tidak suka (Respons ini tidak sesuai harapan).
    • Klik link Saran kode baru untuk memulai lagi dan memasukkan perintah baru untuk Gemini.

    Gemini menampilkan pratinjau penempatan kode saat kursor diarahkan ke tombol Sisipkan.

  10. Klik Simpan Perubahan di file LookML Anda.

  11. Verifikasi LookML dengan melakukan hal berikut:

Tips menggunakan Gemini di Looker IDE

Berikut beberapa tips untuk menggunakan Gemini di Looker IDE:

  • Untuk mendapatkan hasil terbaik, tulis perintah Anda dalam bahasa Inggris Amerika. Lihat dokumentasi batasan Google Cloud Geminiuntuk mengetahui informasi selengkapnya.
  • Panel Bantu saya membuat kode tidak mempertahankan konteks dari perintah sebelumnya dalam percakapan dan tidak mempertahankan perintah di seluruh login dan refresh.
  • Saat Anda menggunakan LookML yang disarankan oleh Gemini, selalu validasi LookML Anda dengan LookML Validator, dan uji kolom baru Anda di Eksplorasi.
  • Bergantung pada permintaan Anda, Gemini dapat menyarankan LookML yang mereferensikan kolom di file tampilan lainnya. Saat Anda menambahkan LookML yang disarankan ke file Anda, simpan file dan jalankan LookML Validator. LookML Validator akan menampilkan error jika Anda perlu menambahkan include pernyataan ke file model Anda.

Contoh perintah

Untuk memberi Anda beberapa ide, berikut beberapa contoh perintah dan hasilnya:

Buat dimensi menggunakan bujur dan lintang

Berikut adalah perintah menggunakan opsi Buat dimensi yang meminta Gemini untuk membuat dimensi baru berdasarkan kolom longitude dan latitude yang ditentukan dalam file tampilan:

show coordinates with longitude and latitude

Gemini menampilkan kode yang disarankan ini:

   dimension: coordinates {
      type: location
      sql_latitude: ${TABLE}.latitude ;;
      sql_longitude: ${TABLE}.longitude ;;
   }

Anda dapat memverifikasi LookML ini di Eksplorasi dengan memilih kolom coordinates baru, beserta kolom longitude dan latitude yang menjadi dasarnya. Karena Gemini membuat dimensi menggunakan type:location, hasil Eksplorasi menyertakan hyperlink untuk melihat koordinat di peta:

Eksplorasi Looker yang menampilkan kolom lintang dan bujur, dengan kolom koordinat baru yang memiliki nilai yang cocok dengan nilai lintang dan bujur.

Buat ukuran untuk total penjualan hari ini

Berikut adalah perintah menggunakan opsi Buat ukuran yang meminta Gemini untuk membuat ukuran baru untuk jumlah semua pesanan hari ini:

show the total sale price of today's orders

Gemini menampilkan kode yang disarankan ini:

   measure: todays_orders {
      type: sum
      sql: ${basic_order_items.sale_price} ;;
      filters: [basic_order_items.created_at_date: "today"]
  }

Memberikan masukan

Anda dapat memberikan masukan untuk LookML yang dihasilkan di panel Bantu saya membuat kode. Jika LookML yang dihasilkan terlihat benar, klik ikon thumb_up suka. Jika LookML yang dihasilkan terlihat salah atau tidak sesuai harapan, klik ikon thumb_down tidak suka.