Menulis kueri dengan bantuan Gemini

Sebagai teknologi tahap awal, Gemini untuk Google Cloud produk dapat menghasilkan output yang tampaknya masuk akal tetapi sebenarnya tidak benar. Sebaiknya Anda memvalidasi semua output dari produk Gemini untuk Google Cloud sebelum Anda menggunakannya. Untuk informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

Anda dapat menggunakan Gemini untuk Google Cloud, yang menawarkan bantuan yang didukung AI, untuk membantu Anda membuat kueri data dengan kueri SQL dan kode Python. Gemini di BigQuery dapat membuat kueri, menyelesaikan kode saat Anda mengetik, dan menjelaskan kueri.

Gemini untuk Google Cloud tidak menggunakan perintah Anda atau responsnya sebagai data untuk melatih modelnya tanpa izin tertulis dari Anda. Untuk mengetahui informasi selengkapnya tentang cara Google menggunakan data Anda, lihat Cara Gemini untuk Google Cloud menggunakan data Anda. Untuk memilih ikut serta dalam berbagi data untuk fitur Gemini di BigQuery dalam pratinjau, lihat Membantu meningkatkan kualitas saran.

Hanya perintah dalam bahasa Inggris yang didukung untuk Gemini di BigQuery.

Dokumen ini ditujukan untuk analis data, data scientist, dan data developer yang menangani kueri SQL dan notebook Colab Enterprise di BigQuery. Dokumen ini mengasumsikan bahwa Anda memiliki pengetahuan tentang cara membuat kueri data di ruang kerja BigQuery SQL atau cara menggunakan notebook untuk menganalisis data BigQuery menggunakan Python.

Sebelum memulai

1. Pastikan Gemini disiapkan untuk project Google Cloud Anda. Fitur Gemini di BigQuery mungkin dinonaktifkan atau tidak tersedia hingga penyiapan selesai. Langkah-langkah ini biasanya dilakukan oleh administrator.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

4. Di toolbar, klik ikon drop-down pen_sparkGemini.

   

5. Di daftar dropdown fitur, pilih fitur yang ingin Anda aktifkan. Fitur yang tersedia meliputi:

   • Gemini dalam kueri SQL:
     • Pelengkapan otomatis (Pratinjau): Saat Anda mengetik di editor kueri, Gemini dapat menyarankan langkah logis berikutnya yang relevan dengan konteks kueri saat ini atau membantu Anda melakukan iterasi pada kueri.
     • Pembuatan otomatis: Anda dapat meminta Gemini di BigQuery dengan komentar dalam bahasa alami di editor kueri BigQuery untuk membuat kueri SQL.
     • Alat pembuatan SQL: Anda dapat memasukkan teks bahasa alami di alat untuk membuat kueri SQL, dengan opsi untuk menyaring hasil kueri, memilih sumber tabel, dan membandingkan hasil.
     • Penjelasan: Anda dapat meminta Gemini di BigQuery untuk menjelaskan kueri SQL dalam natural language.
   • Gemini di notebook Python:
     • Penyelesaian kode (Pratinjau): Gemini memberikan rekomendasi yang sesuai secara kontekstual yang didasarkan pada konten di notebook.
     • Pembuatan kode: Anda dapat meminta Gemini dengan pernyataan atau pertanyaan bahasa alami untuk membuat kode Python.

Izin yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menulis kueri dengan bantuan Gemini, minta administrator untuk memberi Anda peran IAM Gemini for Google Cloud User (roles/cloudaicompanion.user) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menulis kueri dengan bantuan Gemini. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menulis kueri dengan bantuan Gemini:

• cloudaicompanion.entitlements.get
• cloudaicompanion.instances.completeTask
• Untuk menjelaskan kueri SQL: cloudaicompanion.companions.generateChat
• Untuk menyelesaikan kode SQL atau Python: cloudaicompanion.instances.completeCode
• Untuk membuat kode SQL atau Python: cloudaicompanion.instances.generateCode

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Membuat kueri SQL

Untuk membuat kueri SQL berdasarkan skema data, Anda dapat memberikan pernyataan atau pertanyaan bahasa alami pada Gemini, yang juga dikenal sebagai perintah. Meskipun Anda memulai tanpa kode, memiliki pengetahuan terbatas tentang skema data, atau hanya memiliki pengetahuan dasar tentang sintaksis GoogleSQL, Gemini dapat membuat SQL yang dapat membantu Anda menjelajahi data.

Menggunakan alat pembuat kode SQL

Alat pembuatan SQL memungkinkan Anda menggunakan bahasa alami untuk membuat kueri SQL tentang tabel yang baru saja dilihat atau dikueri. Anda juga dapat menggunakan alat ini untuk mengubah kueri yang ada, dan menentukan tabel yang ingin Anda buat SQL-nya secara manual.

Untuk menggunakan alat pembuatan SQL, ikuti langkah-langkah berikut:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di samping editor kueri, klik pen_spark alat pembuat kode SQL.

   

3. Di sebelah kiri editor kueri, klik ikon pen_spark SQL generation tool untuk membuka alat.

4. Di alat pembuatan SQL, ajukan pertanyaan atau masukkan perintah bahasa natural tentang tabel yang baru saja Anda lihat atau kueri. Misalnya, Anda dapat melihat tabel bigquery-public-data.austin_bikeshare.bikeshare_trips, lalu mengetik hal berikut:

    Show me the duration and subscriber type for the ten longest trips
   

5. Klik Generate.

   Gemini menghasilkan kueri SQL yang mirip dengan contoh berikut:

   SELECT
       subscriber_type,
       duration_sec
     FROM
         `bigquery-public-data.san_francisco_bikeshare.bikeshare_trips`
   ORDER BY
       duration_sec DESC
   LIMIT 10;
   

   Catatan: Gemini mungkin menyarankan sintaksis yang berbeda setiap kali Anda memasukkan perintah yang sama.

6. Tinjau kueri SQL yang dihasilkan dan lakukan salah satu tindakan berikut:

   • Untuk menerima kueri SQL yang dihasilkan, klik Sisipkan untuk menyisipkan pernyataan ke editor kueri. Kemudian, Anda dapat mengklik Run untuk menjalankan kueri SQL yang disarankan.
   • Untuk mengedit perintah, klik Edit, lalu ubah atau ganti perintah awal Anda. Setelah mengedit perintah, klik Perbarui untuk melihat kueri baru.
   • Untuk memperbarui sumber tabel yang digunakan sebagai konteks untuk membuat kueri SQL yang disarankan, klik Edit Sumber Tabel, pilih sumber tabel dengan mencentang kotak, lalu klik Terapkan.
   • Untuk melihat ringkasan bahasa alami dari kueri yang dihasilkan, klik Ringkasan Kueri.
   • Untuk menyaring kueri SQL yang disarankan, ketik penyaringan apa pun di kotak teks Saring, lalu klik Kirim untuk menyaring kueri Anda. Misalnya, ketik limit to 1000 untuk membatasi jumlah hasil kueri. Untuk membandingkan perubahan pada kueri Anda, centang kotak Tampilkan perbedaan.
   • Untuk menutup saran tanpa menyisipkan kueri yang dihasilkan, tutup alat pembuat kode SQL.

Menonaktifkan alat pembuat kode SQL

Untuk mempelajari cara menonaktifkan alat pembuat kode SQL, lihat Menonaktifkan fitur Gemini.

Membuat SQL dari komentar

Anda dapat membuat SQL di editor SQL dengan mendeskripsikan kueri yang Anda inginkan dalam komentar, lalu menekan Enter untuk melanjutkan ke baris berikutnya.

Dalam contoh berikut, Anda membuat kueri untuk tabel publik BigQuery, bigquery-public-data.austin_bikeshare.bikeshare_trips.

1. Di konsol Google Cloud, buka halaman BigQuery Studio.

   Buka BigQuery Studio

   Langkah-langkah lainnya akan muncul di konsol Google Cloud.

2. Di editor kueri SQL, klik Buat kueri baru.

   

3. Di editor kueri, tulis komentar SQL tentang tabel yang baru saja Anda lihat atau kueri. Misalnya, Anda dapat melihat tabel bigquery-public-data.austin_bikeshare.bikeshare_trips, lalu menulis komentar berikut:

   # Show me the duration and subscriber type for the ten longest trips
   

4. Tekan Enter (Return di macOS).

   Gemini menyarankan kueri SQL yang mirip dengan contoh berikut:

   # Show me the duration and subscriber type for the ten longest trips
   
   SELECT
     duration_sec,
     subscriber_type
     AVG(duration_minutes) AS average_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   ORDER BY
     duration_sec
   LIMIT 10;
   

5. Untuk menerima saran, tekan Tab.

Tips untuk pembuatan SQL

Tips berikut dapat meningkatkan saran yang diberikan Gemini di BigQuery:

• Untuk menentukan tabel yang akan digunakan secara manual, Anda dapat menyertakan nama tabel yang sepenuhnya memenuhi syarat dalam tanda kutip terbalik (`), seperti `PROJECT.DATASET.TABLE`.
• Jika nama kolom atau hubungan semantiknya tidak jelas atau kompleks, Anda dapat memberikan konteks dalam perintah untuk memandu Gemini menuju jawaban yang Anda inginkan. Misalnya, untuk mendorong kueri yang dihasilkan agar mereferensikan nama kolom, deskripsikan nama kolom dan relevansinya dengan jawaban yang Anda inginkan. Untuk mendorong jawaban yang merujuk ke istilah kompleks seperti nilai umur atau margin kotor, jelaskan konsep dan relevansinya dengan data Anda untuk meningkatkan hasil pembuatan SQL.
• Saat membuat SQL dari komentar, Anda dapat memformat perintah di beberapa baris dengan menambahkan awalan setiap baris dengan karakter #.
• Deskripsi kolom dipertimbangkan saat membuat kueri SQL. Untuk meningkatkan akurasi, tambahkan deskripsi kolom ke skema Anda. Untuk mengetahui informasi selengkapnya tentang deskripsi kolom, lihat Deskripsi kolom di Menentukan skema.

Data Gemini dan BigQuery

Gemini di BigQuery dapat mengakses metadata tabel yang Anda miliki izin untuk mengaksesnya. Hal ini dapat mencakup nama tabel, nama kolom, jenis data, dan deskripsi kolom. Gemini di BigQuery tidak dapat mengakses data dalam tabel, tampilan, atau model Anda. Untuk mengetahui informasi selengkapnya tentang cara Gemini menggunakan data Anda, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.

Menyelesaikan kueri SQL

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Penyelesaian SQL berupaya memberikan rekomendasi yang sesuai secara kontekstual, berdasarkan konten di editor kueri. Saat Anda mengetik, Gemini dapat menyarankan langkah logis berikutnya yang relevan dengan konteks kueri saat ini atau membantu Anda melakukan iterasi pada kueri.

Untuk mencoba penyelesaian SQL dengan Gemini, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery Studio.

   Buka BigQuery Studio

   Langkah-langkah lainnya akan muncul di konsol Google Cloud.

2. Di editor kueri, salin hal berikut:

   SELECT
     subscriber_type
     , EXTRACT(HOUR FROM start_time) AS hour_of_day
     , AVG(duration_minutes) AS avg_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   

   Pesan error yang menyatakan bahwa subscriber_type tidak dikelompokkan atau diagregasi. Memerlukan bantuan untuk mendapatkan kueri yang tepat bukanlah hal yang tidak biasa.

3. Tekan Enter (Return di macOS) atau Spasi.

   Gemini menyarankan penajaman pada kueri yang mungkin berakhir dengan teks yang mirip dengan yang berikut:

   GROUP BY
     subscriber_type, hour_of_day;
   

4. Untuk menerima saran, tekan Tab, atau arahkan kursor ke teks yang disarankan, lalu klik saran alternatif. Untuk menolak saran, tekan ESC atau lanjutkan mengetik.

Menjelaskan kueri SQL

Anda dapat meminta Gemini di BigQuery untuk menjelaskan kueri SQL dalam natural language. Penjelasan ini dapat membantu Anda memahami kueri dengan sintaksis, skema dasar, dan konteks bisnis yang mungkin sulit dinilai karena panjang atau kompleksitas kueri tersebut.

Menjelaskan kueri SQL

Untuk menjelaskan kueri SQL, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery Studio.

   Buka BigQuery Studio

   Langkah-langkah lainnya akan muncul di konsol Google Cloud.

2. Di editor kueri, buka atau tempel kueri yang ingin Anda minta untuk dijelaskan.

3. Tandai kueri yang Anda inginkan untuk dijelaskan oleh Gemini, lalu klik astrophotography_mode Gemini.

   

Penjelasan SQL muncul di panel Gemini.

Membuat kode Python

Anda dapat meminta Gemini dengan pernyataan atau pertanyaan natural language untuk membuat kode Python. Gemini akan merespons dengan memberikan satu atau beberapa saran kode Python.

Menggunakan Gemini untuk membuat kode Python

Dalam contoh berikut, Anda membuat kode untuk set data publik BigQuery, bigquery-public-data.ml_datasets.penguins.

1. Buka halaman BigQuery Studio.

   Buka BigQuery

2. Di panel tab panel editor, klik panah drop-down di samping tanda +, lalu klik Create Python notebook.

   Notebook baru ini akan terbuka, yang berisi sel yang menunjukkan contoh kueri terhadap set data publik bigquery-public-data.ml_datasets.penguins.

3. Di toolbar, klik + Code untuk menyisipkan sel kode baru. Sel kode baru akan muncul yang bertuliskan: Mulai coding atau buat dengan AI.

4. Di sel kode baru, klik generate.

5. Di editor kode, masukkan perintah natural language berikut:

   Using bigquery magics query the `bigquery-public-data.ml_datasets.penguins` table
   

6. Tekan Enter (Return di macOS).

   Gemini menyarankan kode Python yang mirip dengan kode berikut:

   %%bigquery
   SELECT *
   FROM `bigquery-public-data.ml_datasets.penguins`
   LIMIT 10
   

7. Jalankan kode, tekan Enter.

Kode Python lengkap

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Penyelesaian kode Python berupaya memberikan rekomendasi yang sesuai secara kontekstual, berdasarkan konten di editor kueri. Saat Anda mengetik, Gemini dapat menyarankan langkah logis berikutnya yang relevan dengan konteks kode saat ini atau membantu Anda melakukan iterasi pada kode.

Menggunakan Gemini untuk menyelesaikan kode Python

Untuk mencoba penyelesaian kode Python dengan Gemini, ikuti langkah-langkah berikut:

1. Buka halaman BigQuery Studio.

   Buka BigQuery

2. Di panel tab panel editor, klik panah drop-down di samping tanda +, lalu klik Create Python notebook. Notebook baru akan terbuka, yang berisi sel yang menampilkan contoh kueri terhadap set data publik bigquery-public-data.ml_datasets.penguins.

3. Di editor kode, mulai ketik kode Python. Misalnya %%bigquery. Gemini menyarankan kode inline saat Anda mengetik. Untuk menerima saran, tekan Tab.

Menonaktifkan fitur asisten kueri Gemini

Untuk menonaktifkan fitur Gemini di BigQuery, lakukan hal berikut:

1. Di Konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di toolbar, klik ikon drop-down pen_spark Gemini.

   

3. Di menu dropdown fitur, hapus fitur asisten kueri Gemini di BigQuery yang ingin Anda nonaktifkan.

   • Gemini dalam kueri SQL:
     • Pelengkapan otomatis (Pratinjau): Saat Anda mengetik, Gemini dapat menyarankan langkah logis berikutnya yang relevan dengan konteks kueri saat ini atau membantu Anda melakukan iterasi pada kueri.
     • Pembuatan otomatis: Anda dapat memberikan perintah bahasa alami pada Gemini untuk membuat sintaksis SQL yang menjawab pertanyaan bisnis.
     • Alat pembuatan SQL: Gunakan bahasa alami untuk membuat dan mengulangi hasil kueri SQL berdasarkan data organisasi Anda.
     • Penjelasan: Anda dapat meminta Gemini di BigQuery untuk menjelaskan kueri SQL dalam natural language.
   • Gemini di notebook Python:
     • Pelengkapan kode (Pratinjau): Gemini memberikan rekomendasi yang sesuai secara kontekstual, berdasarkan konten di editor kueri.
     • Pembuatan kode: Anda dapat meminta Gemini dengan pernyataan atau pertanyaan bahasa alami untuk membuat kode Python.

Untuk mempelajari cara menonaktifkan fitur Gemini di BigQuery, lihat Menonaktifkan produk Gemini.

Memberikan masukan

Anda dapat memberikan masukan terkait saran Gemini.

• Untuk memberikan masukan, di toolbar, klik pen_spark Gemini, lalu pilih Kirim masukan.

Membantu meningkatkan kualitas saran

Anda dapat membantu meningkatkan kualitas saran Gemini dengan membagikan kepada Google data perintah yang Anda kirimkan ke fitur di Pratinjau. Untuk membagikan data perintah, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud pada halaman BigQuery Studio, di toolbar, klik pen_spark Gemini.

2. Pilih Bagikan data untuk meningkatkan Gemini.

3. Perbarui setelan penggunaan data Anda di dialog setelan penggunaan data.

Setelan berbagi data berlaku untuk seluruh project dan hanya dapat ditetapkan oleh administrator project dengan izin IAM serviceusage.services.enable dan serviceusage.services.list. Untuk mengetahui informasi selengkapnya tentang penggunaan data dalam Program Penguji Tepercaya, lihat Program Penguji Tepercaya Gemini untuk Google Cloud.

Harga

Untuk mengetahui detail harga fitur ini, lihat ringkasan harga Gemini di BigQuery.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas untuk fitur ini, lihat Kuota untuk Gemini di BigQuery.

Langkah selanjutnya

• Untuk informasi tentang Gemini untuk Google Cloud, lihat Ringkasan Gemini untuk Google Cloud.
• Untuk mengetahui informasi tentang kebijakan data Gemini, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.