Dokumen ini menjelaskan cara membuat agen data di Cloud SQL for PostgreSQL Studio menggunakan file konteks agen. Agen data dikaitkan dengan satu file konteks agen.
Untuk mempelajari agen data, lihat Ringkasan agen data.Sebelum memulai
Selesaikan prasyarat berikut sebelum membuat agen.
Mengaktifkan layanan yang diperlukan
Aktifkan layanan berikut untuk project Anda:
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.
- Isi database dengan data dan skema yang ingin diakses pengguna akhir.
Peran dan izin yang diperlukan
- Tambahkan akun pengguna atau layanan IAM ke instance. Untuk informasi selengkapnya, lihat Mengelola pengguna dengan autentikasi database IAM untuk Cloud SQL.
- Berikan peran
cloudsql.studioUserdancloudsql.instanceUserkepada pengguna IAM di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Menambahkan binding kebijakan IAM untuk project. Anda juga harus memberikan hak istimewa database kepada akun pengguna atau
akun layanan IAM. Untuk mengetahui informasi selengkapnya, lihat [Memberikan hak istimewa database kepada akun layanan atau pengguna IAM individu](/sql/docs/postgres/add-manage-iam-users#grant-db-privileges).Anda juga harus memberikan hak istimewa database kepada akun layanan atau pengguna IAM. Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada
akun layanan atau pengguna IAM tertentu.
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 beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID dengan ID instance Cloud SQL Anda.
Membuat agen data
Untuk membuat agen data, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi Identity and Access Management (IAM).
Di panel Explorer, di samping Agen Data, klik Lihat tindakan.
Klik Buat agen.
Di Nama agen, berikan nama agen yang unik. Nama agen peka huruf besar/kecil dan dapat berisi huruf, angka, tanda hubung, dan garis bawah.
Opsional. Di Deskripsi agen, tambahkan deskripsi untuk agen Anda.
Opsional. Klik Show Advanced Options dan di Select a location, pilih region untuk menyimpan konteks agen. Anda dapat memilih dari daftar wilayah yang didukung berikut:
- us-central1
- us-east1
- europe-west4
- asia-southeast1
Klik Create.
Membangun konteks agen
Setelah membuat agen, ikuti langkah-langkah di Membangun konteks menggunakan Gemini CLI untuk membuat file konteks agen. Kemudian, Anda dapat mengedit agen untuk mengupload file konteks.
Mengedit agen
Untuk mengedit agen data, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi Identity and Access Management (IAM).
Di panel Explorer, di samping Agen Data, klik Lihat tindakan.
Klik Edit agen.
Opsional: Edit Deskripsi agen.
Klik Jelajahi di bagian Upload file konteks agen, lalu pilih file konteks agen.
Klik Simpan.
Menghapus agen data
Untuk menghapus agen data, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Cloud SQL.
Pilih instance dari daftar.
Di menu navigasi, klik Cloud SQL Studio.
Login ke Studio menggunakan autentikasi Identity and Access Management (IAM).
Di panel Explorer, di samping Agen Data, klik Lihat tindakan.
Klik Hapus agen.
Di dialog konfirmasi Hapus agen, masukkan nama agen.
Klik Konfirmasi untuk menghapus agen.
Langkah berikutnya
- Pelajari agen data lebih lanjut.
- Pelajari cara memeriksa dan memanggil agen data.