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.

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.

Dokumen ini menjelaskan cara menggunakan Gemini, kolaborator yang didukung AI di Google Cloud, untuk membantu Anda melakukan hal berikut di Spanner:

• Buat kueri SQL menggunakan perintah natural language.
• Melengkapi pernyataan SQL di editor kueri.
• Menjelaskan kueri SQL di editor kueri.

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.

Dokumen ini ditujukan untuk administrator database dan data engineer yang memahami Spanner, SQL, dan analisis data. Jika Anda baru menggunakan Spanner, lihat Membuat dan mengkueri 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, Pelengkapan SQL dan Pembuatan komentar-ke-kueri. Anda dapat memilih dan mencoba fitur sendiri tanpa memengaruhi orang lain yang bekerja dalam 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 Anda perlukan guna menyelesaikan tugas dalam dokumen ini, minta administrator untuk memberi Anda peran IAM Spanner Database Reader (roles/spanner.databaseReader) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses.

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

Membuat kueri SQL menggunakan prompt natural language

Anda dapat memberikan komentar (atau perintah) dalam natural language kepada Gemini untuk menghasilkan 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 Singers."
• "Berapa banyak penyanyi yang lahir di 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 database dan data 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 membuat kueri database, klik Tab editor SQL baru. Pastikan pembuatan SQL diaktifkan.

6. Untuk menghasilkan 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 menghasilkan 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 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 dibuat oleh Gemini, tekan Tab, edit SQL, lalu klik Run.
   • Untuk menutup saran, tekan Esc atau lanjutkan mengetik.

Melengkapi pernyataan SQL di editor kueri

Untuk membantu Anda menulis kode SQL, Gemini di Spanner menyediakan saran penyelesaian kode yang didukung 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 Pelengkapan SQL diaktifkan.

6. Masukkan kueri dan spasi atau baris baru di akhir baris. Saat Anda memasukkan teks, Gemini akan menampilkan saran SQL yang didasarkan pada 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 berikut ini:

   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 dibuat oleh Gemini, tekan Tab, edit SQL, lalu klik Run.
   • Untuk menutup saran, tekan Esc atau lanjutkan mengetik.

Alat bantu coding

Untuk menggunakan alat Bantu coding, 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 Bantu kode di samping editor kueri.

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

   Gemini menghasilkan SQL yang mirip dengan berikut ini:

   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 menyetujui SQL yang dibuat oleh Gemini, klik Insert untuk menyisipkan pernyataan ke dalam editor kueri. Kemudian, klik Run untuk menjalankan 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 jendela Bantu coding.

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 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 Jelaskan kueri ini.

   Penjelasan SQL muncul di panel Gemini.

Langkah selanjutnya

• Baca ringkasan Gemini di Google Cloud.
• Pelajari cara Gemini menggunakan data Anda.
• Pelajari cara menganalisis data di Google Cloud menggunakan Gemini.