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 set konteks di Cloud SQL for MySQL Studio menggunakan file set konteks. Nama set konteks harus unik dalam database.

Untuk mempelajari set konteks, lihat Ringkasan set konteks.

Sebelum memulai

Selesaikan prasyarat berikut sebelum membuat agen.

Mengaktifkan layanan yang diperlukan

Aktifkan layanan berikut untuk project Anda:

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

Siapkan 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 pada 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 pengguna IAM atau akun layanan di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.
• Anda harus memiliki pengguna istimewa yang 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 setiap 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 autentikasi ke database menggunakan autentikasi IAM.

Membuat set konteks

Untuk membuat set konteks, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , 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 Buat set konteks.

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

8. Opsional. Di Deskripsi set konteks, tambahkan deskripsi untuk set konteks Anda.

9. Klik Create.

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

Membangun set konteks

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

Mengedit set konteks

Untuk mengedit set konteks, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , 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 set konteks.

7. Opsional: Edit Deskripsi set konteks.

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

9. Klik Simpan.

Menghapus set konteks

Untuk menghapus set konteks, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud , 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 Hapus set konteks.

7. Di dialog konfirmasi Hapus set konteks, masukkan nama set konteks.

8. Klik Konfirmasi untuk menghapus set konteks.

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

Langkah berikutnya

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