Menulis SQL dengan bantuan Gemini

Dokumen ini menjelaskan cara menggunakan Gemini, kolaborator yang didukung teknologi AI di Cloud de Confiance by S3NS, untuk membantu Anda melakukan hal-hal berikut di Cloud SQL Studio:

Pelajari cara dan waktu Gemini untuk Cloud de Confiance menggunakan data Anda.

Dokumen ini ditujukan untuk administrator database dan data engineer yang sudah memahami SQL, analisis data, dan Cloud SQL. Jika Anda baru menggunakan Cloud SQL, lihat Ringkasan Cloud SQL.

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, 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 MEDIUMBLOB,
  BirthDate  DATETIME
);

    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:

Membuat kueri SQL menggunakan perintah bahasa alami

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:

  • "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, klik refreshRefresh untuk memperbarui skema sebelum menggunakan Gemini.

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

  1. Di konsol Cloud de Confiance , 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 dalam database Anda.

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

  6. Pastikan Comment-to-query generation diaktifkan.

  7. Untuk mengkueri database Anda, 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 akan menghasilkan 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 akan menghasilkan SQL yang mirip dengan berikut ini:

    SELECT *
FROM Singers
WHERE Singers.BirthDate
BETWEEN '1970-01-01' AND '1979-12-31'

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

    • 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.
      • Terima kata: 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 konsol Cloud de Confiance , 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 dalam database Anda.

  5. Untuk mengkueri database Anda, klik New tab.

  6. Klik settings_suggestion Bantu buat kode di samping editor kueri.

  7. Di jendela Bantu buat kode, masukkan perintah. Misalnya, add a row to table singers, lalu 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');

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

    • 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 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 konsol Cloud de Confiance , 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 dalam database Anda.

  5. Untuk mengkueri database Anda, klik New tab.

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

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

Gemini kini menawarkan kemampuan yang diperluas untuk membantu Anda memperbaiki error dalam kueri Cloud SQL tanpa harus keluar dari Cloud SQL Studio.

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

  • Memberikan perbandingan baris demi baris antara kueri asli dan 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.
  • 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:

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 konsol Cloud de Confiance , 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 dalam database Anda.

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

  6. Untuk mengkueri database Anda, klik 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 Perbaiki.

  10. 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 memberikan ringkasan saran edit. Tinjau perubahan yang disarankan pada kueri dan perbarui sesuai kebutuhan. Kemudian, terima dan jalankan kueri baru Anda:

    Klik Accept and run.

Batasan

Langkah berikutnya