Menulis SQL dengan bantuan Gemini

Pratinjau

Produk ini tercakup dalam Persyaratan Penawaran Pra-GA dari Persyaratan Layanan Google Cloud . Produk pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk menulis, menyaring, dan memahami kueri SQL lebih cepat di AlloyDB untuk PostgreSQL, Anda dapat menggunakan Gemini, kolaborator yang didukung AI diGoogle Cloud, untuk menyelesaikan tugas-tugas berikut di AlloyDB Studio:

• 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 memahami AlloyDB, serta cukup memahami SQL dan analisis data. Jika Anda baru menggunakan AlloyDB, lihat Ringkasan AlloyDB.

Sebelum memulai

1. Pastikan Gemini Cloud Assist disiapkan untuk akun pengguna dan project Google Cloud Anda.

2. Opsional: Jika Anda ingin mengikuti contoh dalam dokumen ini, buat tabel Singers menggunakan skema berikut:

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

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

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

Peran dan izin yang diperlukan

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

Untuk menggunakan Gemini dengan AlloyDB, Anda memerlukan izin berikut:

• alloydb.clusters.get
• alloydb.databases.list
• alloydb.instances.executeSql
• alloydb.instances.list
• alloydb.users.list
• cloudaicompanion.companions.generateCode
• cloudaicompanion.instances.generateCode
• serviceusage.services.get atau serviceusage.services.list

Anda bisa mendapatkan izin ini melalui peran roles/alloydb.admin. Jika Anda tidak memiliki peran ini, hubungi Organization Administrator untuk meminta akses. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Selain itu, pastikan Anda memiliki izin tingkat database untuk database yang Anda gunakan untuk autentikasi.

Membuat kueri SQL menggunakan perintah bahasa alami

Sebagai teknologi tahap awal, produk Gemini untuk Google Cloud dapat menghasilkan output yang tampak masuk akal, tetapi berisi fakta yang salah. Sebaiknya Anda memvalidasi semua output dari produk Gemini untuk Google Cloud 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 berdasarkan 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 birthday ke tabel Singers."
• "Berapa banyak penyanyi yang lahir pada tahun 90-an?"

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

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

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

1. Di konsol Google Cloud , buka halaman AlloyDB.

   Buka AlloyDB

2. Pilih cluster dari daftar.

3. Di menu navigasi, klik AlloyDB.

4. Pilih database dan pengguna, lalu masukkan sandi pengguna.

5. Klik Authenticate. Panel Explorer menampilkan daftar objek dalam database Anda.

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

7. 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 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.

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

   Perhatian: Karena kueri Bahasa Pengolahan Data (DML) dan Bahasa Definisi Data (DDL) yang dihasilkan oleh Gemini dapat menimpa data, sebaiknya validasi kueri SQL yang dihasilkan sebelum Anda menjalankan kueri.
   • Untuk melihat opsi guna menerima SQL yang dihasilkan oleh Gemini, arahkan kursor ke kueri. Opsi berikut akan ditampilkan:
     • Accept: Untuk menerima kueri yang disarankan, tekan Tab, lalu klik Run.
     • Accept word: 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 menolak saran, tekan Esc atau lanjutkan mengetik.

Alat Bantu buat kode

Untuk menggunakan alat Bantu buat kode, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud , buka halaman AlloyDB.

   Buka AlloyDB

2. Pilih cluster dari daftar.

3. Di menu navigasi, klik AlloyDB.

4. Pilih database dan pengguna, lalu masukkan sandi pengguna.

5. Klik Authenticate. Panel Explorer menampilkan daftar objek dalam database Anda.

6. Untuk mengkueri database Anda, klik New tab.

7. Klik pen_spark Bantu buat kode di samping editor kueri.

8. Di jendela Bantu buat kode, masukkan perintah. Misalnya, add a row to table singers dan klik Buat.

   Gemini akan membuat 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.

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

   Perhatian: Karena kueri Bahasa Pengolahan Data (DML) dan Bahasa Definisi Data (DDL) yang dihasilkan oleh Gemini dapat menimpa data, sebaiknya validasi kueri yang dihasilkan sebelum Anda menjalankan kueri.
   • Untuk menerima SQL yang dihasilkan 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 mengedit perintah, klik Perbarui. Kemudian, Anda dapat memutuskan untuk menerima pernyataan baru yang dihasilkan atau menutup saran.
   • Untuk menutup saran, tutup jendela Bantu buat kode.

Menjelaskan pernyataan SQL di editor kueri

Anda dapat memasukkan kueri bahasa alami untuk meminta penjelasan kueri SQL. Penjelasan ini dapat membantu Anda memahami sintaksis, skema yang mendasarinya, dan konteks bisnis untuk kueri yang kompleks atau panjang.

1. Di konsol Google Cloud , buka halaman AlloyDB.

   Buka AlloyDB

2. Pilih cluster dari daftar.

3. Di menu navigasi, klik AlloyDB.

4. Pilih database dan pengguna, lalu masukkan sandi pengguna.

5. Klik Authenticate. Panel Explorer menampilkan daftar objek dalam database Anda.

6. Untuk mengkueri database Anda, klik New tab.

7. Di editor kueri, tempel kueri.

8. 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

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 tambahan yang membantu Anda memperbaiki error dalam kueri AlloyDB tanpa harus keluar dari editor kueri.

Kemampuan Gemini yang didukung AI terintegrasi dalam editor kueri untuk memberikan manfaat berikut:

• Memberikan perbandingan baris demi baris antara kueri asli dan 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 tepat terkait dengan kueri untuk memberikan koreksi yang akurat dan relevan.
• Menghilangkan kebutuhan untuk mengandalkan LLM pihak ketiga untuk tujuan umum 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 error sintaksis, skema, dan error runtime.

Izin yang diperlukan

Sebelum memulai, pastikan Anda memiliki izin berikut:

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

Memperbaiki kueri menggunakan Gemini

Untuk menggunakan kemampuan Gemini guna memperbaiki error tertentu dalam kueri, lakukan hal berikut:

1. Di konsol Google Cloud , buka halaman AlloyDB untuk PostgreSQL.

   Buka AlloyDB

2. Pilih cluster dari daftar.

3. Di menu navigasi, klik AlloyDB Studio.

4. Pilih database dan pengguna, lalu masukkan sandi pengguna.

5. Klik Authenticate. Panel Explorer menampilkan daftar objek dalam database Anda.

6. Di taskbar, klik settings_suggestionGemini untuk melihat fitur Gemini di AlloyDB.

7. Untuk mengkueri database Anda, klik New tab.

8. Di editor kueri, masukkan kueri yang mungkin salah atau tidak lengkap.

9. Klik Run.

   Jika kueri berisi masalah, error akan ditampilkan di tab Results.

10. Klik Perbaiki.

    Di jendela kueri, editor perbedaan ("editor diff") akan terbuka di tab, yang menampilkan perbandingan baris demi baris antara kueri yang ada dan perubahan yang direkomendasikan. Editor kueri juga menyediakan ringkasan saran edit.

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

12. Untuk menerima perubahan dan menjalankan kueri baru, klik Accept and run.

Batasan

• Kemampuan ini hanya dapat diakses di editor kueri AlloyDB Studio di konsolGoogle Cloud .
• Batas jendela konteks Gemini saat ini berlaku.

Langkah berikutnya

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