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.

Saat Anda menggunakan agen rekayasa konteks, agen ini dapat membuat dan mengupload set konteks secara otomatis dari CLI Anda. Dokumen ini menjelaskan cara membuat, mengedit, dan menghapus set konteks di Cloud SQL untuk MySQL Studio jika Anda menginginkan antarmuka visual di konsol Google Cloud untuk mengelola file set konteks. Saat Anda membuat set konteks di Cloud SQL Studio, Cloud SQL Studio akan menyimpannya di grup set konteks default project untuk region yang dipilih dan menautkannya ke database saat ini. Nama set konteks (dan ID set konteks turunannya) harus unik dalam grup set konteks default project untuk region tertentu, di semua database dan instance. Di Cloud SQL Studio, pembuatan set konteks dengan nama yang ID turunannya sudah ada akan gagal divalidasi; untuk menimpa kontennya sambil mempertahankan pengaitan databasenya, edit set konteks yang ada. Mengupload langsung melalui agen context engineering atau Dataplex API dengan ID set konteks yang ada akan menggantikan kontennya dan, jika ditentukan, pengaitan databasenya.

Daftar Context sets di Cloud SQL Studio hanya menampilkan set konteks dalam grup set konteks default di semua wilayah yang didukung yang ditautkan ke database saat ini. Set konteks yang dibuat untuk database lain, atau dibuat melalui API tanpa menautkan resource database di databases (atau dalam grup set konteks kustom), tidak akan muncul dalam daftar Cloud SQL Studio.

Untuk mempelajari set konteks, lihat Ringkasan set konteks.

Sebelum memulai

Selesaikan prasyarat berikut sebelum membuat atau mengupload set konteks.

Set konteks dapat dibuat di region us-central1, us-east1, europe-west4, dan asia-southeast1.

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 informasi selengkapnya, lihat Membuat database pada instance Cloud SQL.

Peran dan izin yang diperlukan

• Aktifkan autentikasi database IAM pada instance dengan menetapkan flag database cloudsql_iam_authentication ke on (cloudsql_iam_authentication=on). Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi instance yang ada untuk autentikasi database IAM.
• Menambahkan akun pengguna atau layanan IAM di level instance. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM ke pengguna, akun layanan, atau grup.
• Berikan peran roles/cloudsql.studioUser, roles/cloudsql.instanceUser, roles/serviceusage.serviceUsageConsumer, dan roles/geminidataanalytics.queryDataUser kepada pengguna atau akun layanan IAM di level project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project.
• Untuk membuat, mengupload, dan mengelola set konteks, berikan peran Dataplex Catalog Editor (roles/dataplex.catalogEditor) atau Dataplex Catalog Admin (roles/dataplex.catalogAdmin) kepada pengguna IAM atau akun layanan di level project. Untuk mengetahui informasi selengkapnya, lihat Context menetapkan izin.
• Anda harus memiliki pengguna dengan hak istimewa yang memberikan hak istimewa database kepada akun pengguna atau layanan IAM.
  
  GRANT SELECT ON DATABASE_NAME.* TO 'IAM_USERNAME'@'%';
  
  Ganti DATABASE_NAME dengan nama database Anda dan IAM_USERNAME dengan nama pengguna IAM tanpa @ dan akhiran domain (misalnya, [e-mail] menjadi user, sehingga menghasilkan 'user'@'%').
  
  Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada akun pengguna atau layanan IAM individual.

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 sql instances patch INSTANCE_ID --project=PROJECT_ID --data-api-access=ALLOW_DATA_API

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud 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 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 Cloud SQL 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 konteks yang unik. Di Cloud SQL Studio, nama harus terdiri dari 4 hingga 30 karakter dan tidak boleh diawali dengan spasi kosong; Studio memperoleh ID set konteks dengan mengonversi nama menjadi huruf kecil dan mengganti karakter non-alfanumerik dengan tanda hubung (-), dan ID set konteks yang diperoleh harus unik dalam grup set konteks default project untuk region yang dipilih. Misalnya, nama set konteks querydata_e2e_test memiliki ID set konteks querydata-e2e-test. Saat Anda mengupload set konteks secara langsung menggunakan agen context engineering atau Dataplex API, ID set konteks peka huruf besar/kecil, tidak boleh berisi garis miring (/), dan tidak dibatasi hingga 4 hingga 30 karakter atau karakter alfanumerik, tanda hubung, dan garis bawah.

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

9. Opsional. Untuk mengupload file set konteks, klik Browse di bagian Upload context set file, lalu pilih file set konteks.

10. Opsional. Untuk memilih region bagi set konteks, klik Show Advanced Options dan pilih region di Select a location (setelan defaultnya adalah us-east1 pada setiap pembuatan). Jika Anda memilih region selain us-east1, pilih region sebelum memasukkan nama set konteks agar Cloud SQL Studio memvalidasi keunikan nama di region tersebut.

11. Klik Create.

Catatan: Membuat set konteks dari Cloud SQL Studio dapat memerlukan waktu hingga beberapa menit saat Cloud SQL Studio memproses set konteks. Pembuatan atau upload set konteks melalui agen rekayasa konteks atau Dataplex API biasanya selesai dalam beberapa detik.

Membuat set data konteks

Jika Anda membuat set konteks kosong di Studio, atau ingin memperbarui set konteks yang ada, ikuti langkah-langkah di bagian Membangun dan mengoptimalkan set konteks dengan agen context engineering untuk membuat dan mengoptimalkan file set konteks. Agen context engineering dapat membuat dan mengupload set konteks Anda langsung dari CLI, atau Anda dapat mengedit set konteks di Studio untuk mengupload file set konteks secara manual.

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 Cloud SQL Studio menggunakan autentikasi IAM.

5. Klik Lihat tindakan di samping set konteks yang ingin Anda edit.

6. Klik Edit context set.

7. Opsional. Edit Deskripsi set data konteks.

8. Klik Browse di bagian Upload context set file, 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 Cloud SQL Studio menggunakan autentikasi IAM.

5. Klik View actions di samping set konteks yang ingin Anda hapus.

6. Klik Hapus set konteks.

7. Dalam dialog konfirmasi Delete context set, masukkan ID set konteks.

8. Klik Confirm untuk menghapus set konteks.

Catatan: Menghapus database tidak akan menghapus set konteksnya. Untuk menghindari set konteks tanpa induk yang masih mengekspos detail skema, hapus set konteks tersebut sebelum Anda menghapus database.

Langkah berikutnya

• Pelajari lebih lanjut set konteks.
• Pelajari cara menguji QueryData di Cloud SQL Studio.
• Pelajari cara membuat dan mengoptimalkan set konteks dengan agen rekayasa konteks.
• Pelajari cara mengintegrasikan QueryData dengan aplikasi.