Mengelola set konteks di Cloud SQL Studio

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan, dan Persyaratan Tambahan untuk Produk Pratinjau AI Generatif. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Dokumen ini menjelaskan cara membuat set konteks di Cloud SQL untuk MySQL Studio menggunakan file set konteks. Nama set data konteks harus unik dalam database.

Untuk mempelajari set data konteks, lihat Ringkasan set data konteks.

Sebelum memulai

Selesaikan prasyarat berikut sebelum membuat agen.

Mengaktifkan layanan yang diperlukan

Aktifkan layanan berikut untuk project Anda:

• Data Analytics API with Gemini
• Gemini for Google Cloud API
• Knowledge Catalog API

Menyiapkan instance Cloud SQL

• Pastikan Anda memiliki akses ke instance Cloud SQL yang ada atau buat instance baru. Untuk mengetahui informasi selengkapnya, lihat Membuat instance untuk Cloud SQL.
• Pastikan Anda membuat database di instance tempat Anda akan membuat tabel. Untuk mengetahui informasi selengkapnya, lihat Membuat database di instance Cloud SQL.

Peran dan izin yang diperlukan

• Tambahkan akun pengguna atau layanan IAM di tingkat instance. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM ke pengguna, akun layanan, atau grup.
• Berikan peran cloudsql.studioUser, cloudsql.instanceUser, dan geminidataanalytics.queryDataUser kepada akun pengguna atau layanan IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.
• Untuk membuat, mengupload, dan mengelola set data konteks, berikan peran Editor Katalog Dataplex (roles/dataplex.catalogEditor) atau Admin Katalog Dataplex (roles/dataplex.catalogAdmin) kepada akun pengguna atau layanan IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Izin set data konteks.
• Anda harus memiliki pengguna yang memiliki hak istimewa untuk memberikan hak istimewa database kepada akun pengguna atau layanan IAM.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada akun pengguna atau layanan IAM.

Memberikan izin executesql ke instance Cloud SQL

Untuk memberikan izin executesql ke instance Cloud SQL dan mengaktifkan Cloud SQL Data API, jalankan perintah berikut:

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Ganti kode berikut:

• PROJECT_ID: ID Google Cloud project Anda.
• INSTANCE_ID: ID instance Cloud SQL Anda.

Untuk melakukan langkah-langkah dalam tutorial ini, login ke Google Cloud, lalu lakukan autentikasi ke database menggunakan autentikasi IAM.

Membuat set data konteks

Untuk membuat set data konteks, lakukan 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 Studio menggunakan autentikasi IAM.

5. Di panel Explorer, di samping Context sets, klik View actions.

6. Klik Create context set.

7. Di Context set name, berikan nama set data konteks yang unik. Nama set data konteks bersifat peka huruf besar/kecil dan dapat berisi huruf, angka, tanda hubung, dan garis bawah.

8. Opsional. Di Context set description, tambahkan deskripsi untuk set data konteks Anda.

9. Klik Create.

Catatan: Pembuatan set data konteks pertama dalam project dapat memerlukan waktu beberapa menit.

Mem-build set data konteks

Setelah membuat set data konteks, ikuti langkah-langkah di Mem-build konteks menggunakan Gemini CLI untuk membuat file set data konteks. Kemudian, Anda dapat mengedit set data konteks untuk mengupload file set data konteks.

Mengedit set data konteks

Untuk mengedit set data konteks, lakukan 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 Studio menggunakan autentikasi IAM.

5. Di panel Explorer, di samping Context sets, klik View actions.

6. Klik Edit context set.

7. Opsional. Edit Context set description.

8. Klik Browse di bagian Upload context set file, lalu pilih file set data konteks.

9. Klik Save.

Menghapus set data konteks

Untuk menghapus set data konteks, lakukan 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 Studio menggunakan autentikasi IAM.

5. Di panel Explorer, di samping Context sets, klik View actions.

6. Klik Delete context set.

7. Di dialog konfirmasi Delete context set, masukkan nama set data konteks.

8. Klik Confirm untuk menghapus set data konteks.

Catatan: Sebelum menghapus database, Anda harus menghapus semua set data konteks yang terkait dengan database tersebut.

Langkah berikutnya

• Pelajari lebih lanjut set data konteks.
• Pelajari cara menguji set data konteks.
• Pelajari cara mem-build konteks menggunakan Gemini CLI.