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

Dokumen ini menjelaskan cara menggunakan Gemini, sebuah kolaborator yang didukung teknologi AI di Google Cloud, untuk membantu Anda melakukan hal-hal berikut di Cloud SQL 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 biasa menggunakan SQL, analisis data, dan Cloud SQL. Jika Anda baru menggunakan Cloud SQL, lihat Ringkasan Cloud SQL.

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 tanggal mendatang. Pada saat itu, Anda harus mendapatkan lisensi Gemini Code Assist Standard Edition untuk terus menggunakan bantuan coding di Cloud SQL Studio.

Sebelum memulai

1. Untuk menyelesaikan tugas dalam dokumen ini, pastikan Anda memiliki izin Identity and Access Management (IAM) yang diperlukan.
2. Konfirmasi akses ke Cloud SQL Studio. Jika Anda tidak memiliki akses ke Cloud SQL Studio, maka lihat Peran dan izin yang diperlukan Cloud SQL Studio

3. 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 VARBINARY(MAX),
     BirthDate  DATETIMEOFFSET
   );
   

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

Peran dan izin yang diperlukan

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

Anda juga memerlukan izin berikut:

• Izin serviceusage.services.list atau serviceusage.services.get untuk kemampuan baca
• Izin cloudaicompanion.companions.generateChat untuk menggunakan pernyataan SQL yang dijelaskan di editor kueri
• Izin cloudaicompanion.companions.generateCode untuk menggunakan bantu buat kode

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) pada Gemini untuk membuat kueri yang didasarkan pada skema Anda. Misalnya, Anda dapat meminta Gemini untuk membuat SQL sebagai respons terhadap perintah berikut:

• "Tambahkan kolom tanggal bernama ulang tahun ke tabel Penyanyi."
• "Berapa banyak penyanyi yang lahir pada tahun 90-an?"

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

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

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

1. Di Google Cloud Konsol, 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 panel tugas, klik settings_suggestionGemini untuk melihat fitur Gemini di Cloud SQL.

6. Pastikan Comment-to-query generation diaktifkan.

7. Untuk mengkueri database, klik New SQL editor tab.

8. Untuk membuat 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 Return atau Enter. Gemini membuat SQL yang mirip dengan contoh berikut:

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

   Untuk melanjutkan contoh menggunakan tabel Singers, masukkan perintah berikut:

   -- show all singers born in the 70s
   

   Gemini membuat SQL yang mirip dengan contoh berikut:

   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:

   Perhatian: Karena kueri Data Manipulation Language (DML) dan Data Definition Language (DDL) yang dibuat oleh Gemini dapat menimpa data, sebaiknya validasi kueri yang dibuat sebelum Anda menjalankan kueri.
   • Untuk melihat opsi menerima SQL yang dibuat oleh Gemini, arahkan kursor ke kueri. Opsi berikut akan ditampilkan:
     • Terima: Untuk menerima kueri yang disarankan, tekan Tab, lalu klik Jalankan.
     • Accept word: Untuk menerima kueri yang disarankan sebagian, 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 Google Cloud Konsol, 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 mengkueri database, klik the New tab.

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

7. Di jendela Help me code, masukkan perintah. Misalnya, add a row to table singers dan klik Generate.

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

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

   Perhatian: Karena kueri Data Manipulation Language (DML) dan Data Definition Language (DDL) yang dibuat oleh Gemini dapat menimpa data, sebaiknya validasi kueri yang dibuat sebelum Anda menjalankan kueri.
   • Untuk menerima 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 mengedit perintah, klik Update. Kemudian, Anda dapat memutuskan untuk menerima pernyataan yang baru dibuat atau menolak saran.
   • Untuk menolak saran, tutup jendela Help me code.

Menjelaskan pernyataan SQL di editor kueri

Anda dapat menggunakan Gemini di Cloud SQL 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 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 mengkueri database, klik the New tab.

6. Di editor kueri, tempel kueri yang ingin Anda minta untuk dijelaskan.

7. Tandai kueri yang Anda inginkan untuk dijelaskan oleh Gemini, dan 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 — Gemini Code Assist

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 kini menawarkan kemampuan yang diperluas yang membantu Anda memperbaiki error dalam kueri Cloud SQL tanpa harus keluar dari Cloud SQL Studio.

Kemampuan yang didukung AI Gemini terintegrasi dalam Cloud SQL Studio untuk memberikan manfaat berikut:

• Memberikan perbandingan baris per baris dari kueri asli di samping kueri baru dengan perubahan yang direkomendasikan menggunakan editor Cloud SQL Studio.
• Menandai segmen kueri asli yang mungkin menyebabkan masalah dan memberikan ringkasan perubahan dalam bahasa alami.
• Mereferensikan pesan error dan informasi skema yang terkait dengan kueri untuk memberikan koreksi yang akurat dan relevan.
• Menghilangkan kebutuhan untuk mengandalkan LLM pihak ketiga dan tujuan umum yang mungkin memberikan bantuan yang kurang mendalam dan juga dapat mengekspos data Anda ke potensi risiko keamanan risiko.
• Memberikan pemecahan masalah yang lebih cepat dan efisien untuk masalah umum seperti error sintaksis, skema, dan runtime.

Izin yang diperlukan

Sebelum memulai, pastikan Anda memiliki izin berikut:

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

Memperbaiki kueri menggunakan Gemini dan Cloud SQL Studio

Untuk menggunakan kemampuan Gemini guna memperbaiki error tertentu dalam kueri di Cloud SQL Studio, selesaikan langkah-langkah berikut:

1. Di Google Cloud Konsol, 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 panel tugas, klik settings_suggestionGemini untuk melihat fitur Gemini di Cloud SQL.

6. Untuk mengkueri database, klik the New tab.

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

8. Klik Run.

   Jika kueri berisi masalah, error akan ditampilkan.

   Misalnya, pesan yang ditampilkan mungkin berupa error validasi di tab Run, atau pesan error di tab Results.

9. Klik Fix.

10. Di jendela kueri, editor perbedaan ("diff editor") akan terbuka di tab, yang menampilkan perbandingan baris per baris dari kueri yang ada dengan perubahan yang direkomendasikan. Editor kueri juga memberikan ringkasan pengeditan yang disarankan. Tinjau perubahan yang disarankan pada kueri dan perbarui sesuai kebutuhan. Kemudian, terima dan jalankan kueri baru Anda:

    Klik Accept and run.

Batasan

• Kemampuan ini hanya dapat diakses dalam Cloud SQL Studio di Google Cloud konsol.
• Batas jendela konteks Gemini saat ini berlaku.

Langkah berikutnya

• Baca Ringkasan Gemini untuk Google Cloud gambaran umum.
• Pelajari cara Gemini menggunakan data Anda.
• Pelajari cara menganalisis data Anda di Google Cloud menggunakan Gemini.