Dokumen ini menjelaskan cara membuat agen data di Cloud SQL for MySQL 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.
- 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.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 layanan IAM dengan login sebagai pengguna berbasis sandi dari
database.
GRANT ALL PRIVILEGES ON * TO "IAM_USERNAME";.
Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada setiap akun layanan atau pengguna 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 components update gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID dengan ID instance Cloud SQL Anda.
Untuk melakukan langkah-langkah dalam tutorial ini, login ke Cloud de Confiance by S3NS, lalu autentikasi ke database menggunakan autentikasi IAM.
Membuat agen data
Untuk membuat agen data, lakukan langkah-langkah berikut:
Di konsol Cloud de Confiance by S3NS , 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, lalu di Select a location, pilih region untuk menyimpan konteks agen. Anda dapat memilih dari daftar wilayah yang didukung berikut:
us-central1us-east1europe-west4asia-southeast1
Klik Buat.
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 Cloud de Confiance , 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 Cloud de Confiance , 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.