Mengelola set konteks di AlloyDB Studio

Dokumen ini menjelaskan cara membuat set data konteks di AlloyDB 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 cluster, instance, dan database AlloyDB untuk PostgreSQL

Pastikan Anda memiliki akses ke cluster dan instance AlloyDB yang ada atau buat yang baru.
Tutorial ini mengharuskan Anda memiliki database di instance AlloyDB. Untuk mengetahui informasi selengkapnya, lihat Membuat database.

Peran dan izin yang diperlukan

  • Tambahkan akun pengguna atau layanan Identity and Access Management (IAM) ke cluster di tingkat database. Untuk mengetahui informasi selengkapnya, lihat Mengelola pengguna database.
  • Berikan peran alloydb.databaseUser, serviceusage.serviceUsageConsumer, 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 data 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 data konteks.

Memberikan izin executesql ke instance AlloyDB untuk PostgreSQL

Untuk memberikan izin executesql ke instance AlloyDB untuk PostgreSQL dan menetapkan setelan instance data_api_access ke nilai ALLOW_DATA_API, gunakan perintah curl berikut: 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Ganti hal berikut:
  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: Region tempat cluster AlloyDB Anda berada.
  • CLUSTER_ID: ID cluster AlloyDB Anda.
  • INSTANCE_ID: ID instance AlloyDB 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 data konteks, lakukan langkah-langkah berikut:

  1. DI Google Cloud console, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik AlloyDB Studio.

  4. Login ke 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 data konteks yang unik. Nama set data konteks bersifat peka huruf besar/kecil dan dapat berisi huruf, angka, tanda hubung, dan garis bawah.

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

  9. Klik Create.

Membuat set data konteks

Setelah membuat set data konteks, ikuti langkah-langkah di Membuat 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:

  1. DI Google Cloud console, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik AlloyDB Studio.

  4. Login ke Studio menggunakan autentikasi IAM.

  5. Di panel Explorer, di samping Context sets, klik View actions.

  6. Klik Edit context set.

  7. Opsional. Edit Context set description.

  8. Klik Browse di bagian Upload context set file, lalu pilih file set data konteks.

  9. Klik Save.

Menghapus set data konteks

Untuk menghapus set data konteks, lakukan langkah-langkah berikut:

  1. DI Google Cloud console, buka halaman AlloyDB.

    Buka AlloyDB

  2. Pilih cluster dari daftar.

  3. Di menu navigasi, klik AlloyDB Studio.

  4. Login ke Studio menggunakan autentikasi IAM.

  5. Di panel Explorer, di samping Context sets, klik View actions.

  6. Klik Delete context set.

  7. Di dialog konfirmasi Delete context set, masukkan nama set data konteks.

  8. Klik Confirm untuk menghapus set data konteks.

Langkah berikutnya