Menulis SQL dengan bantuan Gemini

Pratinjau — Gemini di Spanner

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

Dokumen ini menjelaskan cara menggunakan Gemini Code Assist untuk mendapatkan bantuan yang didukung AI terkait hal-hal berikut di Spanner:

• Membuat kueri SQL menggunakan perintah bahasa alami.
• Menjelaskan kueri SQL di editor kueri.

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

Dokumen ini ditujukan untuk administrator database dan data engineer yang sudah terbiasa dengan Spanner, SQL, dan analisis data. Jika Anda baru menggunakan Spanner, lihat Membuat dan mengkueri database menggunakan konsol Google Cloud .

Catatan: Bantuan coding adalah bagian dari Gemini Code Assist dan tersedia tanpa biaya hingga disertakan dalam Gemini Code Assist Standard Edition. Perubahan ini akan dikomunikasikan di lain waktu. Pada saat itu, Anda harus mendapatkan lisensi edisi Gemini Code Assist Standard untuk terus menggunakan bantuan coding di Spanner Studio.

Sebelum memulai

1. Opsional: Siapkan Gemini Code Assist.

2. Untuk menyelesaikan tugas dalam dokumen ini, pastikan Anda memiliki izin Identity and Access Management (IAM) yang diperlukan.

3. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

4. Pilih instance dari daftar.

5. Pilih database.

6. Di menu navigasi, klik Spanner Studio.

7. Di Spanner Studio, klik tombol settings_suggestion Gemini Code Assist untuk melihat fitur Gemini di Spanner.

8. Pilih fitur Gemini yang ingin Anda aktifkan—misalnya, Pembuatan kueri dari komentar. Anda dapat memilih dan mencoba fitur sendiri tanpa memengaruhi orang lain yang mengerjakan project Anda.

9. Opsional: Jika Anda ingin mengikuti contoh dalam dokumen ini, buat terlebih dahulu tabel Singers seperti yang dijelaskan dalam artikel Membuat skema untuk database Anda.

Untuk menonaktifkan fitur Gemini di Spanner, ulangi langkah-langkah ini, lalu batalkan pilihan fitur Gemini yang ingin Anda nonaktifkan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menyelesaikan tugas dalam dokumen ini, minta administrator Anda untuk memberi Anda peran IAM Gemini for Google Cloud User (roles/cloudaicompanion.user) di project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat kueri SQL menggunakan perintah bahasa alami

Sebagai teknologi tahap awal, Gemini untuk produk Google Cloud dapat menghasilkan output yang seolah masuk akal, tetapi mengandung fakta yang salah. Sebaiknya Anda memvalidasi semua output dari Gemini untuk Google Cloud produk sebelum Anda menggunakannya. Untuk mengetahui informasi selengkapnya, lihat Gemini untuk Google Cloud dan responsible AI.

Anda dapat memberikan komentar bahasa alami (atau perintah) kepada Gemini untuk membuat kueri yang didasarkan pada skema Anda. Misalnya, Anda dapat meminta Gemini untuk membuat SQL sebagai respons terhadap perintah berikut:

• "Buat tabel yang melacak hasil survei kepuasan pelanggan."
• "Tambahkan kolom tanggal bernama ulang tahun ke tabel Penyanyi."
• "Berapa banyak penyanyi yang lahir pada tahun 90-an?"

Catatan: Saat Anda memasukkan perintah untuk Gemini di Spanner, informasi tentang skema database Anda akan disertakan dengan perintah tersebut. Hal ini dapat mencakup nama tabel dan kolom, jenis data, dan deskripsi kolom. Skema dan data database Anda tetap berada di Spanner dan tidak dikirim ke Gemini.

Untuk membuat SQL di Spanner dengan bantuan Gemini, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

2. Pilih instance dari daftar.

3. Pilih database.

4. Di panel navigasi, klik Spanner Studio. Panel Explorer menampilkan daftar objek dalam database Anda.

5. Untuk mengkueri database, klik Tab baru. Pastikan pembuatan SQL diaktifkan.

6. Untuk membuat SQL, ketik komentar di editor kueri yang diawali dengan --, diikuti dengan komentar satu baris, lalu tekan Return.

   Misalnya, jika Anda memasukkan perintah -- add a row to table singers dan menekan Return, Gemini akan membuat SQL yang mirip dengan berikut:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

   Untuk melanjutkan contoh menggunakan tabel Singers, jika Anda memasukkan perintah -- show all singers born in the 70s, Gemini akan membuat SQL yang mirip dengan berikut ini:

   SELECT *
   FROM Singers
   WHERE Singers.BirthDate
   BETWEEN '1970-01-01' AND '1979-12-31'
   
   

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

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

   • Untuk menerima SQL yang dihasilkan oleh Gemini, tekan Tab, lalu klik Run untuk menjalankan SQL yang disarankan.
   • Untuk mengedit SQL yang dihasilkan oleh Gemini, tekan Tab, edit SQL, lalu klik Run.
   • Untuk menutup saran, tekan Esc atau lanjutkan mengetik.

Menjelaskan pernyataan SQL di editor kueri

Anda dapat menggunakan Gemini di Spanner untuk menjelaskan kueri SQL dalam natural language. Penjelasan ini dapat membantu Anda memahami sintaksis, skema dasar, dan konteks bisnis untuk kueri yang kompleks atau panjang.

1. Di konsol Google Cloud , buka halaman Spanner.

   Buka Spanner

2. Pilih instance dari daftar.

3. Pilih database.

4. Di panel navigasi, klik Spanner Studio.

5. Untuk mengkueri database, klik Tab baru.

6. Di editor kueri, tempel kueri.

7. Tandai kueri yang Anda inginkan untuk dijelaskan oleh Gemini, lalu klik astrophotography_mode Explain this selected query.

   Penjelasan SQL akan muncul di panel Gemini Cloud Assist.

Menggunakan Gemini untuk memperbaiki error dalam kueri

Pratinjau — Gemini Code Assist

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Anda dapat memproses data pribadi untuk fitur ini sebagaimana diuraikan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada kewajiban dan batasan yang dijelaskan dalam perjanjian yang menjadi dasar Anda mengakses Google Cloud. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Gemini menawarkan kemampuan yang lebih luas yang membantu Anda memperbaiki kesalahan dalam kueri Spanner tanpa harus keluar dari editor kueri.

Kemampuan berteknologi AI Gemini diintegrasikan dalam Spanner Studio untuk memberikan manfaat berikut:

• Memberikan perbandingan baris demi baris dari kueri asli di samping kueri baru dengan perubahan yang direkomendasikan menggunakan editor kueri.
• Menandai segmen kueri asli yang mungkin menyebabkan masalah dan memberikan ringkasan perubahan dalam bahasa alami.
• Merujuk pada pesan error dan informasi skema yang terkait dengan kueri untuk memberikan koreksi yang akurat dan relevan.
• Menghilangkan kebutuhan untuk mengandalkan LLM serbaguna pihak ketiga yang mungkin memberikan bantuan yang kurang bernuansa dan juga dapat mengekspos data Anda ke potensi risiko keamanan.
• Memberikan pemecahan masalah yang lebih cepat dan efisien untuk masalah umum seperti kesalahan sintaksis, skema, dan runtime.

Izin yang diperlukan

Sebelum memulai, pastikan Anda memiliki izin berikut:

• Peran yang diuraikan dalam Peran yang diperlukan.
• Izin Gemini untuk Google Cloud API, cloudaicompanion.googleapis.com/instances.generateCode.

Memperbaiki kueri Anda menggunakan Gemini

Untuk menggunakan kemampuan Gemini dalam memperbaiki error tertentu dalam kueri, selesaikan langkah-langkah berikut:

1. Di editor kueri, jalankan kueri Anda.

   Jika kueri berisi error, pesan error akan ditampilkan di banner error di bagian bawah editor.

2. Klik Perbaiki.

   Di jendela kueri, editor perbedaan ("editor diff") akan terbuka di tab, yang menampilkan perbandingan baris demi baris dari kueri yang ada dengan perubahan yang direkomendasikan. Editor kueri juga memberikan ringkasan saran pengeditan.

3. Tinjau perubahan yang disarankan pada kueri dan perbarui sesuai kebutuhan.

4. Untuk menerima perubahan dan menjalankan kueri baru, klik Terima dan jalankan.

Batasan

• Kemampuan ini hanya dapat diakses di editor kueri Spanner Studio di Google Cloud konsol.
• Batas jendela konteks Gemini saat ini berlaku.

Langkah berikutnya

• Baca Ringkasan Gemini untuk Google Cloud .
• Pelajari cara Gemini menggunakan data Anda.