Mengelola set konteks di Cloud SQL for MySQL Studio

MySQL   |  PostgreSQL   |  SQL Server

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.

Untuk mengetahui informasi tentang akses ke rilis ini, lihat halaman permintaan akses.

Dokumen ini menjelaskan cara membuat kumpulan konteks di Cloud SQL for MySQL Studio menggunakan file kumpulan konteks. Nama kumpulan konteks harus unik dalam database.

Untuk mempelajari kumpulan konteks, lihat Ringkasan kumpulan 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
• Dataplex Universal 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.
• 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 project Anda. Google Cloud
• 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 kumpulan konteks

Untuk membuat kumpulan 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 kumpulan konteks yang unik. Nama kumpulan 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 kumpulan konteks Anda.

9. Klik Create.

Catatan: Membuat kumpulan konteks pertama dalam project dapat memerlukan waktu beberapa menit.

Membuat kumpulan konteks

Setelah membuat kumpulan konteks, ikuti langkah-langkah di Membuat konteks menggunakan Gemini CLI untuk membuat file kumpulan konteks. Kemudian, Anda dapat mengedit kumpulan konteks untuk mengupload file kumpulan konteks.

Mengedit kumpulan konteks

Untuk mengedit kumpulan 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 Identity and Access Management.

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

9. Klik Save.

Menghapus kumpulan konteks

Untuk menghapus kumpulan 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 Identity and Access Management.

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

8. Klik Confirm untuk menghapus kumpulan konteks.

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

Langkah berikutnya

• Pelajari lebih lanjut kumpulan konteks.
• Pelajari cara menguji kumpulan konteks.
• Pelajari cara membuat konteks menggunakan Gemini CLI.