Menulis SQL dengan bantuan Gemini

MySQL   |  PostgreSQL   |  SQL Server

Pratinjau — Gemini Code Assist

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Anda dapat memproses data pribadi untuk fitur ini sebagaimana dijelaskan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada kewajiban dan batasan yang dijelaskan dalam perjanjian tempat Anda mengakses Google Cloud. 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-hal berikut di Cloud SQL Studio:

• Membuat 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 mengerti SQL, analisis data, dan Cloud SQL. Jika Anda baru menggunakan Cloud SQL, lihat ringkasan Cloud SQL.

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. Mengonfirmasi akses ke Cloud SQL Studio. Jika Anda tidak memiliki akses ke Cloud SQL Studio, lihat Peran dan izin yang diperlukan Cloud SQL Studio

4. Opsional: Untuk mengikuti contoh dalam dokumen ini, buat tabel Singers menggunakan skema berikut:

   CREATE TABLE
   Singers (
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA,
     BirthDate  TIMESTAMPTZ
   );
   

   Setelah membuat tabel Singers, klik refreshRefresh untuk memperbarui skema database Anda.

Peran dan izin yang diperlukan

Perhatian: Pengguna dengan akses database yang luas dapat mengalami kehilangan data saat menggunakan Gemini di Database. Sebaiknya gunakan akun dengan lebih sedikit hak istimewa database saat menggunakan Gemini di Database.

Untuk mendapatkan izin yang Anda perlukan guna menyelesaikan tugas dalam dokumen ini, minta administrator untuk memberi Anda peran IAM Cloud SQL Admin (roles/cloudsql.admin) 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.

Anda juga memerlukan izin cloudaicompanion.companions.generateChat untuk menggunakan penjelasan pernyataan SQL di editor kueri dan cloudaicompanion.companions.generateCode untuk menggunakan help me code.

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?"

Jika skema Anda berubah, seperti penambahan tabel atau kolom baru, klik refreshRefresh untuk memperbarui skema sebelum menggunakan Gemini.

Catatan: Saat Anda memasukkan perintah untuk Gemini di Cloud SQL, informasi tentang skema database Anda akan disertakan bersama perintah tersebut. Metadata ini dapat mencakup nama tabel dan kolom, jenis data, serta deskripsi kolom. Data database Anda tetap tersimpan di Cloud SQL dan tidak dikirim ke Gemini.

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

1. Di konsol Google Cloud, buka halaman Cloud SQL.

   Buka Cloud SQL

2. Pilih instance dari daftar.

3. Di menu navigasi, klik Cloud SQL Studio.

4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Explorer menampilkan daftar objek di database Anda.

5. Di taskbar, klik pen_sparkGemini untuk melihat fitur Gemini di Cloud SQL.

6. Pastikan Pembuatan komentar ke kueri diaktifkan.

7. Untuk membuat kueri database, klik Tab editor SQL baru.

8. Untuk menghasilkan SQL, ketik komentar di editor kueri yang dimulai dengan --, diikuti dengan komentar satu baris, lalu tekan Return atau Enter.

   Misalnya, masukkan perintah berikut:

   -- add a row to table singers
   

   Tekan tombol Return atau Enter. Gemini menghasilkan SQL yang mirip dengan berikut ini:

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

   Untuk melanjutkan contoh dengan menggunakan tabel Singers, masukkan perintah berikut:

   -- show all singers born in the 70s
   

   Gemini 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 kueri yang berbeda setiap kali Anda memasukkan perintah yang sama.

9. Tinjau saran SQL dan lakukan salah satu tindakan berikut:

   • Untuk melihat opsi untuk menerima SQL yang dihasilkan oleh Gemini, tahan kursor ke kueri. Opsi berikut akan ditampilkan:
     • Accept: Untuk menerima kueri yang disarankan, tekan Tab, lalu klik Run.
     • Menerima kata: Untuk menerima sebagian kueri yang disarankan, tekan Control+Right arrow. (atau Command+Right arrow di macOS), lalu klik Run.
   • Untuk mengedit SQL asli, 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 Cloud SQL.

   Buka Cloud SQL

2. Pilih instance dari daftar.

3. Di menu navigasi, klik Cloud SQL Studio.

4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Explorer menampilkan daftar objek di database Anda.

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.

Melengkapi pernyataan SQL di editor kueri

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

Untuk menggunakan saran kode inline, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Cloud SQL.

   Buka Cloud SQL

2. Pilih instance dari daftar.

3. Di menu navigasi, klik Cloud SQL Studio.

4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Explorer menampilkan daftar objek di database Anda.

5. Di taskbar, klik pen_sparkGemini untuk melihat fitur Gemini di Cloud SQL.

6. Pilih SQL completion.

7. Untuk membuat kueri database, klik Tab editor SQL baru.

8. 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 kueri 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 kueri yang berbeda setiap kali Anda memasukkan pernyataan yang sama.

9. Tinjau saran SQL dan lakukan salah satu tindakan berikut:

   • Untuk melihat opsi untuk menerima SQL yang dihasilkan oleh Gemini, tahan kursor ke kueri. Opsi berikut akan ditampilkan:
     • Accept: Untuk menerima kueri yang disarankan, tekan Tab, lalu klik Run.
     • Menerima kata: Untuk menerima sebagian kueri yang disarankan, tekan Control+Right arrow. (atau Command+Right arrow di macOS), lalu klik Run.
   • Untuk mengedit SQL asli, 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 Cloud SQL 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 Cloud SQL.

   Buka Cloud SQL

2. Pilih instance dari daftar.

3. Di menu navigasi, klik Cloud SQL Studio.

4. Login ke Cloud SQL Studio menggunakan nama database, nama pengguna, dan sandi Anda. Panel Explorer menampilkan daftar objek di database Anda.

5. Untuk membuat kueri database, klik Tab baru.

6. Di editor kueri, tempel kueri yang ingin Anda jelaskan.

7. Tandai kueri yang Anda inginkan untuk dijelaskan oleh Gemini, lalu klik spark Jelaskan kueri ini.

   Penjelasan untuk kueri SQL akan muncul di jendela Chat Gemini.

Langkah selanjutnya

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