Menulis SQL dengan bantuan Gemini

Pratinjau — Gemini in Spanner

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.

Dokumen ini menjelaskan cara menggunakan Gemini di Database untuk mendapatkan bantuan yang didukung teknologi AI dengan hal berikut di Spanner:

• Buat kueri SQL menggunakan perintah bahasa natural.
• Menyelesaikan pernyataan SQL di editor kueri.
• 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 membuat kueri database menggunakan Konsol Google Cloud.

Sebelum memulai

1. Pastikan Anda telah menyiapkan Gemini di Database.
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 taskbar, klik pen_spark Gemini untuk melihat fitur Gemini di Spanner.

8. Pilih fitur Gemini yang ingin Anda aktifkan—misalnya, penyelesaian SQL dan Pembuatan komentar menjadi kueri. Anda dapat memilih dan mencoba fitur untuk diri 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.

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

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk menyelesaikan tugas dalam dokumen ini, minta administrator 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 natural

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 memberikan komentar bahasa alami (atau perintah) pada 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 yang disebut 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, serta 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 di database Anda.

5. Untuk membuat kueri database, klik Tab editor SQL baru. Pastikan bahwa 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:

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

   Untuk melanjutkan contoh menggunakan tabel Singers, jika Anda memasukkan prompt -- show all singers born in the 70s, Gemini akan menghasilkan 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.

Menyelesaikan pernyataan SQL di editor kueri

Untuk membantu Anda menulis kode SQL, Gemini di Spanner menyediakan saran penyelesaian kode dengan bantuan AI. Dengan mengaktifkan Gemini, saat Anda memasukkan teks di editor kueri Spanner Studio, Gemini akan memprediksi dan mengisi otomatis kode SQL.

Saran kode inline

Untuk menggunakan saran kode inline, 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.

5. Untuk membuat kueri database, klik Tab editor SQL baru. Pastikan penyelesaian SQL diaktifkan.

6. Masukkan kueri dan spasi atau baris baru di akhir baris. Saat Anda memasukkan teks, Gemini akan menampilkan SQL yang disarankan berdasarkan objek yang didukung dalam skema database yang dipilih.

   Misalnya, untuk menambahkan baris ke tabel Singers, mulailah menulis SQL berikut: INSERT INTO Singers.

   Gemini menyarankan SQL yang mirip dengan yang berikut:

   INSERT INTO Singers
   (SingerId, FirstName, LastName, BirthDate)
   VALUES
     (1, 'Marc', 'Singer', '1970-03-24')
   

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

7. Tinjau saran SQL 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.

Alat bantu buat kode

Untuk menggunakan alat Bantu saya membuat kode, 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.

5. Untuk membuat kueri database, klik tab Baru.

6. Klik pen_spark Help me code di samping editor kueri.

7. Di jendela Bantu tulis kode, masukkan perintah. Misalnya, add a row to table singers, lalu klik Buat.

   Gemini menghasilkan SQL yang mirip dengan contoh berikut:

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

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

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

   • Untuk menerima SQL yang dihasilkan oleh Gemini, klik Sisipkan untuk menyisipkan pernyataan ke dalam editor kueri. Kemudian, klik Run untuk menjalankan SQL yang disarankan.
   • Untuk meminta Gemini membuat kueri baru, klik Edit. Setelah mengedit perintah, klik Perbarui. Kemudian, Anda dapat memutuskan untuk menerima pernyataan baru yang dibuat atau menutup saran.
   • Untuk menutup saran, tutup jendela Bantu saya membuat kode.

Menjelaskan pernyataan SQL di editor kueri

Anda dapat menggunakan Gemini di Spanner untuk menjelaskan kueri SQL dalam bahasa natural. 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 membuat kueri database, klik tab Baru.

6. Di editor kueri, tempel kueri.

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

   Penjelasan SQL muncul di panel Gemini.

Langkah selanjutnya

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