Mengelola set konteks di Cloud SQL Studio

Dokumen ini menjelaskan cara membuat set konteks di Cloud SQL untuk PostgreSQL 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:

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.

Tutorial ini mengharuskan Anda memiliki database di instance Cloud SQL. Untuk informasi selengkapnya, lihat Membuat database pada instance Cloud SQL.

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.studioUser, cloudsql.instanceUser, dan geminidataanalytics.queryDataUser kepada pengguna IAM di tingkat 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 di tingkat project. Untuk mengetahui informasi selengkapnya, lihat Izin set konteks.
  • 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 pengguna. Anda harus menggunakan tanda kutip di sekitar email karena berisi karakter khusus (@ dan .).

    Untuk mengetahui informasi selengkapnya, lihat Memberikan hak istimewa database kepada akun layanan atau pengguna IAM perorangan.

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

  5. Di panel Explorer, di samping Set konteks, klik Lihat tindakan.

  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.

Membangun set data 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 data 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 IAM.

  5. Di panel Explorer, di samping Set konteks, klik Lihat tindakan.

  6. Klik Edit set konteks.

  7. Opsional. Edit Deskripsi set data konteks.

  8. Klik Jelajahi 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 IAM.

  5. Di panel Explorer, di samping Set konteks, klik Lihat tindakan.

  6. Klik Hapus set konteks.

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

  8. Klik Konfirmasi untuk menghapus set konteks.

Langkah berikutnya