Mengelola set konteks di Cloud SQL for PostgreSQL Studio

MySQL   |  PostgreSQL   |  SQL Server

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan, dan Persyaratan Tambahan untuk Produk Pratinjau AI Generatif. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengetahui informasi tentang akses ke rilis ini, lihat halaman permintaan akses.

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

• Data Analytics API dengan Gemini
• Gemini for Google Cloud API
• Dataplex Universal Catalog API

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.
• 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 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 Context sets, klik View actions.

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.

Catatan: Pembuatan set konteks pertama dalam project dapat memerlukan waktu beberapa menit.

Membangun set 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 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 Identity and Access Management.

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

6. Klik Edit set konteks.

7. Opsional: Edit Deskripsi set konteks.

8. Klik Browse 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 Identity and Access Management.

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

6. Klik Hapus set konteks.

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

8. Klik Konfirmasi untuk menghapus set konteks.

Catatan: Sebelum menghapus database, Anda harus menghapus semua set konteks yang terkait dengan database tersebut.

Langkah berikutnya

• Pelajari lebih lanjut set konteks.
• Pelajari cara menguji set konteks.
• Pelajari cara membuat konteks menggunakan Gemini CLI.