Menulis SQL dengan bantuan Gemini

Pratinjau

Produk ini tercakup dalam Persyaratan Penawaran Pra-GA dari Google Cloud Persyaratan Layanan. 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.

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

• Buat kueri SQL menggunakan perintah bahasa natural.
• Menyelesaikan kueri SQL di editor kueri.
• Menjelaskan kueri SQL di editor kueri.

Pelajari cara dan waktu Gemini untuk Google Cloud menggunakan data Anda.

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

Catatan: Bantuan coding adalah bagian dari Gemini Code Assist dan tersedia tanpa biaya hingga disertakan dalam edisi Gemini Code Assist Standard. Perubahan ini akan disampaikan di lain waktu. Pada saat itu, Anda harus memperoleh lisensi edisi Standar Gemini Code Assist untuk terus menggunakan bantuan coding di AlloyDB untuk PostgreSQL Studio.

Sebelum memulai

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

```sql
CREATE TABLE Singers (
  BirthDate  TIMESTAMPTZ,
  SingerId   BIGINT PRIMARY KEY,
  FirstName  VARCHAR(1024),
  LastName   VARCHAR(1024),
  SingerInfo BYTEA
);
```
After you create the `Singers` table, click
<span class="material-symbols-outlined">refresh</span>**Refresh** to
update your database schema.

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

Anda bisa mendapatkan izin ini melalui peran roles/alloydb.admin. Jika Anda tidak memiliki peran ini, hubungi Administrator Organisasi untuk meminta akses. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran kustom 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 natural

Sebagai teknologi tahap awal, Gemini untuk produk Google Cloud dapat menghasilkan output yang tampaknya masuk akal, tetapi sebenarnya tidak benar, terutama saat mengeluarkan operasi Data Manipulation Language (DML) atau Data Definition Language (DDL) tulis. Sebaiknya Anda memvalidasi semua output dari produk Gemini untuk Google Cloud sebelum menggunakannya. Untuk 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:

• "Buat tabel yang melacak hasil survei kepuasan pelanggan".
• "Tambahkan kolom tanggal yang disebut ulang tahun ke tabel Penyanyi".
• "Berapa banyak penyanyi yang lahir pada tahun 90-an?"

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

Catatan: Saat Anda memasukkan perintah untuk Gemini di AlloyDB, informasi tentang skema database Anda akan disertakan dengan perintah tersebut. Hal ini dapat mencakup nama tabel dan kolom, jenis data, dan 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 Autentikasi. Panel Explorer menampilkan daftar objek di database Anda.

6. Untuk membuat kueri database, klik Tab editor SQL baru. Pastikan bahwa 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:

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

   Untuk melanjutkan contoh menggunakan tabel Singers, jika Anda memasukkan prompt -- 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:

   • Untuk melihat opsi guna menerima SQL yang dihasilkan oleh Gemini, arahkan kursor ke kueri. Opsi berikut akan ditampilkan:
     • Terima: Untuk menerima kueri yang disarankan, tekan Tab, lalu klik Jalankan.
     • Terima kata: Untuk menerima kueri yang disarankan sebagian, tekan Control+Right arrow. (atau Command+Right arrow di macOS), lalu klik Jalankan.
   • Untuk mengedit SQL asli, tekan Tab, edit SQL, lalu klik Run.
   • Untuk menutup saran, tekan Esc atau lanjutkan mengetik.

Alat bantu buat kode

Untuk menggunakan alat Bantu saya membuat 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 Autentikasi. Panel Explorer menampilkan daftar objek di database Anda.

6. Untuk membuat kueri database, klik tab Baru.

7. Klik pen_spark Help me code di samping editor kueri.

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

   Gemini menghasilkan SQL yang mirip dengan 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:

   • Untuk menerima SQL yang dihasilkan oleh Gemini, klik Sisipkan 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 saya membuat kode.

Menyelesaikan pernyataan SQL di editor kueri

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

Untuk menggunakan saran kode inline, 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 Autentikasi. Panel Explorer menampilkan daftar objek di database Anda.

6. Untuk membuat kueri database, klik Tab editor SQL baru. Pastikan penyelesaian SQL diaktifkan.

7. Masukkan kueri dan spasi atau baris baru di akhir baris. Saat Anda memasukkan teks, Gemini akan menampilkan SQL yang disarankan berdasarkan objek yang didukung dalam skema database yang dipilih.

   Misalnya, untuk menambahkan baris ke tabel Singers, mulailah menulis SQL berikut: INSERT INTO Singers.

   Gemini akan menyarankan SQL yang mirip dengan contoh berikut:

   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.

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

Menjelaskan pernyataan SQL di editor kueri

Anda dapat menggunakan Gemini di AlloyDB 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 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 Autentikasi. Panel Explorer menampilkan daftar objek di database Anda.

6. Untuk membuat kueri database, klik tab Baru.

7. Di editor kueri, tempel kueri.

8. Tandai kueri yang Anda ingin minta Gemini jelaskan, lalu klik pen_spark Jelaskan kueri ini.

   Penjelasan SQL muncul di jendela Chat Gemini.

Langkah selanjutnya

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