Menulis kueri dengan bantuan Gemini

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.

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

Anda dapat menggunakan Gemini untuk Google Cloud, yang menawarkan bantuan dengan teknologi AI, untuk membantu Anda melakukan berbagai hal berikut di BigQuery:

• Membuat kueri SQL.
• Melengkapi kueri SQL.
• Menjelaskan kueri SQL.
• Buat kode Python.
• Lengkapi kode Python.

Gemini tidak menggunakan perintah Anda atau responsnya sebagai data untuk melatih modelnya. Untuk mengetahui informasi selengkapnya, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.

Hanya perintah berbahasa Inggris yang didukung untuk Gemini di BigQuery.

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

Sebelum memulai

1. 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

2. Pastikan Gemini disiapkan untuk project Google Cloud Anda. Tombol Gemini tidak akan terlihat sampai penyiapan selesai.
3. Untuk menggunakan Gemini dengan kode Python, aktifkan BigQuery Studio untuk pengelolaan aset.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menulis kueri dengan bantuan Gemini, minta administrator untuk memberi Anda peran IAM Cloud AI Companion User (roles/cloudaicompanion.user) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Izin yang diperlukan

Izin berikut diperlukan untuk menulis kueri dengan bantuan Gemini:

• cloudaicompanion.companions.generateCode
• cloudaicompanion.entitlements.get

Anda mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Membuat kueri SQL

Untuk membuat kueri SQL berdasarkan skema data, Anda dapat memberi Gemini pernyataan atau pertanyaan bahasa alami (juga dikenal sebagai prompt). Meskipun Anda memulai tanpa kode, pengetahuan terbatas tentang skema data, atau hanya memiliki pengetahuan dasar tentang sintaksis GoogleSQL, Gemini dapat menghasilkan satu atau beberapa pernyataan SQL yang dapat membantu Anda mengeksplorasi data.

Menggunakan alat Bantu coding

Alat Bantu coding memungkinkan Anda menggunakan natural language untuk menghasilkan kueri SQL yang kemudian dapat Anda jalankan di BigQuery Studio.

Untuk menggunakan alat Bantu coding, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman BigQuery.

   Buka BigQuery

2. Di editor kueri BigQuery Studio, klik Create SQL query.

3. Di toolbar, klik pen_sparkGemini, lalu pilih Alat pembuatan kode jika belum dipilih.

   

4. Di samping editor kueri, klik pen_spark Bantu kode.

   

5. Di alat Bantu coding, masukkan perintah. Contoh:

    Using `bigquery-public-data.austin_bikeshare.bikeshare_trips`, show me the
    ten longest trip lengths by subscriber type.
   

6. Klik Buat.

   Gemini menghasilkan kueri SQL yang mirip dengan berikut ini:

   SELECT subscriber_type,
     MAX(duration_minutes) AS longest_trip_duration
   FROM `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   GROUP BY subscriber_type
   ORDER BY longest_trip_duration DESC
   LIMIT 10;
   

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

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

   • Untuk menerima kueri SQL yang dihasilkan, klik Insert untuk menyisipkan pernyataan ke dalam editor kueri. Kemudian, klik Run untuk menjalankan kueri SQL yang disarankan.
   • Untuk meminta Gemini membuat kueri baru, klik Edit. Setelah Anda mengedit perintah Anda, klik Perbarui. Selanjutnya, Anda dapat memutuskan untuk menerima pernyataan baru yang dihasilkan atau menolak saran tersebut.
   • Untuk menutup saran, tutup dialog Bantu coding.

8. Untuk meminta Gemini membuat kueri baru menggunakan sumber tabel tertentu, klik Edit table sources, pilih sumber tabel baru, lalu klik Apply. Anda dapat menerima pernyataan baru atau menolak saran.

Menonaktifkan alat Bantu coding

Untuk mempelajari cara menonaktifkan alat Bantu coding, lihat Menonaktifkan fitur Gemini.

Perintah untuk membuat kueri SQL

Untuk menghasilkan SQL, ketik karakter # di editor kueri BigQuery diikuti dengan pernyataan natural language atau pertanyaan tentang informasi yang Anda inginkan. Gemini meninjau kueri terbaru Anda untuk menemukan skema tabel yang mungkin relevan dengan perintah Anda. Jika mengetahui tabel yang ingin digunakan, Anda dapat menentukan nama tabel dengan tanda aksen rendah (`) pada perintah.

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 selanjutnya akan muncul secara otomatis di Konsol Google Cloud.

2. Di editor kueri SQL, klik Create a new query.

3. Di toolbar, klik pen_spark Gemini, lalu pilih Auto-generation jika belum dipilih.

   

4. Di editor kueri, masukkan perintah natural language berikut:

   # Using `bigquery-public-data.austin_bikeshare.bikeshare_trips`, calculate the
   # average trip length by subscriber type.
   

5. Tekan Enter (Return di macOS).

   Gemini menyarankan kueri SQL yang mirip dengan contoh berikut ini:

   SELECT
     subscriber_type,
     AVG(duration_minutes) AS average_trip_length
   FROM
     `bigquery-public-data.austin_bikeshare.bikeshare_trips`
   GROUP BY
     subscriber_type
   

6. Untuk menerima saran, tekan Tab.

Lihat saran tambahan

Gemini mungkin menyarankan lebih dari satu pernyataan SQL yang menjawab perintah Anda. Contoh:

1. Di editor kueri, masukkan perintah natural language berikut, lalu tekan Enter (Return di macOS):

   # Write a query that creates a table in the dataset `1234` with a string column called "name"
   

   Gemini menyarankan kueri SQL.

2. Untuk melihat apakah ada saran tambahan, arahkan kursor ke kueri SQL yang disarankan.

3. Klik saran tambahan, lalu lakukan salah satu hal berikut:

   • Untuk menerima saran, tekan Tab.
   • Untuk menerima kata tertentu, tekan Control+Panah Kanan (Command+Panah Kanan di macOS).
   • Untuk menutup saran, tekan Esc.

Tips untuk pembuatan SQL

Tips berikut dapat meningkatkan saran yang diberikan Gemini di BigQuery:

• Untuk menentukan skema data, berikan nama tabel yang sepenuhnya memenuhi syarat dan diapit tanda kutip terbalik (`), seperti `PROJECT.DATASET.TABLE`.
• Jika nama kolom atau hubungan semantiknya tidak jelas atau rumit, Anda dapat memberikan konteks dalam perintah untuk memandu Gemini menuju jawaban yang Anda inginkan. Teknik ini dikenal sebagai rekayasa perintah. 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 SQL pembuatan konten.
• Perintah dapat diperluas hingga beberapa baris di editor kueri, tetapi setiap baris harus diawali dengan karakter #.

Data Gemini dan BigQuery

Gemini di BigQuery dapat mengakses metadata tabel yang izin aksesnya Anda miliki. Termasuk nama tabel, nama kolom, tipe data, dan deskripsi kolom. Gemini di BigQuery tidak dapat mengakses data di tabel, tampilan, atau model Anda. Untuk mengetahui informasi selengkapnya tentang cara Gemini menggunakan data Anda, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.

Menonaktifkan pembuatan kode SQL

Untuk mempelajari cara menonaktifkan pembuatan kode SQL di BigQuery, lihat Menonaktifkan fitur Gemini.

Menyelesaikan kueri SQL

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 selanjutnya akan muncul secara otomatis di Konsol Google Cloud.

2. Di toolbar, klik pen_spark Gemini, lalu pilih Pelengkapan otomatis jika belum dipilih.

   

3. 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.

4. Tekan Enter (Return di macOS) atau Space.

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

   GROUP BY
     subscriber_type, hour_of_day;
   

5. 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.

Izin tambahan yang diperlukan

Selain izin yang diperlukan untuk menulis kueri dengan Gemini, untuk menjelaskan SQL, Anda harus memiliki izin cloudaicompanion.companions.generateChat. Izin ini disertakan dalam peran IAM Cloud AI Companion User (roles/cloudaicompanion.user).

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 selanjutnya akan muncul secara otomatis di Konsol Google Cloud.

2. Di toolbar, klik pen_spark Gemini, lalu pilih Explanation jika belum dipilih.

   

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

4. Tandai kueri yang Anda ingin Gemini jelaskan, lalu klik astrophotography_mode Jelaskan kueri ini.

   

Penjelasan SQL muncul di panel Gemini.

Membuat kode Python

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

Izin tambahan yang diperlukan

Selain izin yang diperlukan untuk menulis kueri dengan Gemini, Anda harus memiliki izin cloudaicompanion.instances.generateCode untuk membuat kode Python. Izin ini tercakup dalam peran IAM Cloud AI Companion User (roles/cloudaicompanion.user).

Gunakan Gemini untuk membuat kode Python

Pada 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 toolbar, klik pen_sparkGemini, lalu di bagian Gemini in Python notebooks, pilih Codegeneration jika belum dipilih.

   

3. 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.

4. Di toolbar, klik + Kode untuk menyisipkan sel kode baru. Sel kode baru akan muncul dan bertuliskan: Mulai coding atau buat dengan AI.

5. Di sel kode baru, klik generate.

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

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

7. Tekan Enter (Return di macOS).

   Gemini menyarankan kode Python yang mirip dengan yang berikut ini:

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

Pelengkapan kode Python

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

Izin tambahan yang diperlukan

Selain izin yang diperlukan untuk menulis kueri dengan Gemini, Anda harus memiliki izin cloudaicompanion.instances.completeCode untuk membuat kode Python. Izin ini tercakup dalam peran IAM Cloud AI Companion User (roles/cloudaicompanion.user).

Menggunakan Gemini untuk menyelesaikan kode Python

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

1. Buka halaman BigQuery Studio.

   Buka BigQuery

2. Di toolbar, klik pen_sparkGemini, lalu di bagian Gemini in Python notebook, pilih Code completion jika belum dipilih.

   

3. 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.

4. Di editor kode, mulailah mengetik kode Python. Gemini menyarankan agar kode menjadi inline saat Anda mengetik. Untuk menerima saran, tekan Tab.

Menonaktifkan fitur Gemini

Untuk menonaktifkan fitur Gemini di BigQuery, lakukan hal berikut:

1. Di toolbar editor kueri SQL, klik pen_spark Gemini.

2. Hapus fitur Gemini yang ingin dinonaktifkan.

Memberikan masukan

Anda dapat memberikan masukan tentang saran Gemini.

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

Bantu tingkatkan kualitas saran

Anda dapat membantu meningkatkan saran Gemini dengan membagikan data perintah Anda ke Google. Untuk membagikan data perintah Anda, 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 pada 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 Gemini untuk Program Penguji Tepercaya Google Cloud.

Langkah selanjutnya

• Guna mengetahui informasi tentang Gemini untuk Google Cloud, lihat Menggunakan Gemini untuk bantuan dan pengembangan AI.
• Untuk mengetahui informasi tentang kebijakan data Gemini, lihat Cara Gemini untuk Google Cloud menggunakan data Anda.