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 dengan 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 biasa menggunakan Spanner, SQL, dan analisis data. Jika Anda baru menggunakan Spanner, lihat Membuat dan mengkueri database menggunakan Google Cloud konsol.

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 pada lain waktu. Pada saat itu, Anda harus mendapatkan lisensi Gemini Code Assist Standard Edition 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 Google Cloud konsol, buka halaman Spanner.

   Buka Spanner

4. Pilih instance dari daftar.

5. Pilih database.

6. Di Navigation menu, 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, Comment-to-query generation. Anda dapat memilih dan mencoba fitur sendiri tanpa memengaruhi orang lain yang bekerja di project Anda.

9. Opsional: Jika Anda ingin mengikuti contoh dalam dokumen ini, buat tabel Singers terlebih dahulu seperti yang dijelaskan dalam 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 Anda perlukan untuk 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 pemberian 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 Google Cloud produk dapat menghasilkan output yang seolah masuk akal tetapi mengandung fakta yang salah. Sebaiknya validasi 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 dalam 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 Google Cloud konsol, 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 di database Anda.

5. Untuk mengkueri database, klik New SQL editor tab. Pastikan pembuatan SQL diaktifkan.

6. Untuk membuat SQL, ketik komentar di editor kueri yang dimulai 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 ini:

   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 dibuat dan lakukan salah satu tindakan berikut:

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

Menjelaskan pernyataan SQL di editor kueri

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

1. Di Google Cloud konsol, 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 the New tab.

6. Di editor kueri, tempel kueri.

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

   Penjelasan SQL muncul di panel Gemini.

Langkah berikutnya

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