Menulis LookML dengan bantuan Gemini

Halaman dokumentasi ini menjelaskan cara menggunakan bantuan Gemini untuk membuat dimensi, grup dimensi, dan ukuran, dalam project LookML. Membuat 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:
  • Anda harus diberi peran Looker yang berisi izin develop untuk setidaknya satu model dalam project LookML.
  • Anda harus diberi peran Gemini Looker.

Menggunakan Gemini di IDE Looker

Untuk menggunakan Gemini dalam 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 pada baris di file tampilan LookML. Berdasarkan jenis file LookML dan tempat kursor Anda berada 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:

    • Membuat grup dimensi
    • Membuat dimensi
    • Membuat pengukuran
    • 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 penggunaan 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 dalam file Anda. Anda dapat memindahkan kursor ke baris lain dalam file untuk melihat pratinjau di lokasi yang berbeda sebelum menyisipkan LookML dalam file.
    • Klik tombol Edit untuk mengubah LookML yang disarankan secara manual.
    • Klik tombol Sisipkan untuk menyisipkan LookML ke dalam file di lokasi kursor Anda.
    • Berikan masukan tentang kode yang disarankan dengan memilih ikon suka (Respons ini membantu) atau ikon tidak suka (Respons ini tidak sesuai dengan yang saya harapkan).
    • 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 hasil terbaik, tulis perintah Anda dalam bahasa Inggris Amerika. Lihat dokumentasi Batasan Gemini untuk Google Cloud untuk mengetahui informasi selengkapnya.
  • Panel Bantu saya membuat kode tidak mempertahankan konteks dari perintah sebelumnya dalam percakapan dan tidak mempertahankan perintah di seluruh proses login dan pemuatan ulang.
  • Saat Anda menggunakan LookML yang disarankan oleh Gemini, selalu validasi LookML Anda dengan Validator LookML, dan uji kolom baru Anda di Eksplorasi.
  • Bergantung pada permintaan Anda, Gemini dapat menyarankan LookML yang mereferensikan kolom dalam file tampilan lain. Saat Anda menambahkan LookML yang disarankan ke file, simpan file dan jalankan Validator LookML. Validator LookML akan menampilkan error jika Anda perlu menambahkan pernyataan include ke file model.

Contoh perintah

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

Membuat dimensi menggunakan bujur dan lintang

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

show coordinates with longitude and latitude

Gemini menampilkan saran kode 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 membuat ukuran baru untuk jumlah semua pesanan hari ini:

show the total sale price of today's orders

Gemini menampilkan saran kode ini:

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

Berikan masukan

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