Dokumen ini menjelaskan cara membuat set data konteks di Cloud SQL untuk PostgreSQL Studio menggunakan file set data 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: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.Tutorial ini mengharuskan Anda memiliki database di instance Cloud SQL. Untuk mengetahui informasi selengkapnya, lihat Membuat database di instance Cloud SQL
Peran dan izin yang diperlukan
- Tambahkan akun pengguna atau layanan IAM ke instance. Untuk mengetahui informasi selengkapnya, lihat Mengelola pengguna dengan autentikasi database IAM untuk Cloud SQL.
- Berikan peran
cloudsql.studioUser,cloudsql.instanceUser, dangeminidataanalytics.queryDataUserkepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project. - Anda juga harus memberikan hak istimewa database hanya baca kepada pengguna atau akun layanan IAM dengan login sebagai pengguna yang memiliki hak istimewa superuser, seperti pengguna
postgres.GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
Ganti USER_NAME dengan alamat email untuk pengguna. Anda harus menggunakan tanda kutip di sekitar email karena berisi karakter khusus (@ dan .).
Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada pengguna atau akun 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
PROJECT_ID: ID project Anda. Google CloudINSTANCE_ID: ID instance Cloud SQL Anda.
Membuat set data konteks
Untuk membuat set data konteks, lakukan langkah-langkah berikut:
Di Google Cloud Konsol, buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi IAM.
Di panel Explorer, di samping Context sets, klik View actions.
Klik Create context set.
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.
Opsional. Di Context set description, tambahkan deskripsi untuk set data konteks Anda.
Klik Create.
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:
Di Google Cloud Konsol, buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi Identity and Access Management.
Di panel Explorer, di samping Context sets, klik View actions.
Klik Edit context set.
Opsional: Edit Context set description.
Klik Browse di bagian Upload context set file, lalu pilih file set data konteks.
Klik Save.
Menghapus set data konteks
Untuk menghapus set data konteks, lakukan langkah-langkah berikut:
Di Google Cloud Konsol, buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi Identity and Access Management.
Di panel Explorer, di samping Context sets, klik View actions.
Klik Delete context set.
Di dialog konfirmasi Delete context set, masukkan nama set data konteks.
Klik Confirm untuk menghapus set data konteks.
Langkah berikutnya
- Pelajari lebih lanjut set data konteks.
- Pelajari cara menguji set data konteks.
- Pelajari cara mem-build konteks menggunakan Gemini CLI.