Mengelola set konteks di Spanner Studio

Saat Anda menggunakan agen rekayasa konteks, agen ini dapat membuat dan mengupload set konteks secara otomatis dari CLI Anda. Dokumen ini menjelaskan cara membuat, mengedit, dan menghapus set konteks di Spanner Studio jika Anda menginginkan antarmuka visual di konsol Google Cloud untuk mengelola file set konteks. Saat Anda membuat set konteks di Spanner Studio, Spanner Studio akan menyimpannya di grup set konteks default project untuk region yang dipilih dan menautkannya ke database saat ini. Nama set konteks (dan ID set konteks turunannya) harus unik dalam grup set konteks default project untuk region tertentu, di semua database dan instance. Di Spanner Studio, pembuatan set konteks dengan nama yang ID turunannya sudah ada akan gagal divalidasi; untuk menimpa kontennya sambil mempertahankan pengaitan database-nya, edit set konteks yang ada. Mengupload langsung melalui agen context engineering atau Dataplex API dengan ID set konteks yang ada akan menggantikan kontennya dan, jika ditentukan, pengaitan databasenya.

Daftar Context sets di Spanner Studio hanya menampilkan set konteks dalam grup set konteks default di semua wilayah yang didukung yang ditautkan ke database saat ini. Set konteks yang dibuat untuk database lain, atau dibuat melalui API tanpa menautkan resource database di databases (atau dalam grup set konteks kustom), tidak akan muncul dalam daftar Spanner Studio.

Untuk mempelajari set konteks, lihat Ringkasan set konteks.

Sebelum memulai

Selesaikan prasyarat berikut sebelum membuat atau mengupload set konteks.

Set konteks dapat dibuat di region us-central1, us-east1, europe-west4, dan asia-southeast1.

Mengaktifkan layanan yang diperlukan

Aktifkan layanan berikut untuk project Anda:

Menyiapkan instance Spanner

Peran dan izin yang diperlukan

  • Tambahkan akun pengguna atau layanan IAM ke instance. Untuk mengetahui informasi selengkapnya, lihat Menerapkan peran IAM.
  • Berikan peran roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer, dan roles/geminidataanalytics.queryDataUser kepada pengguna IAM di level 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 level project. Untuk mengetahui informasi selengkapnya, lihat Izin set konteks.
  • Berikan peran dan izin kepada pengguna IAM di level project untuk database yang diperlukan.

Membuat set data konteks

Untuk membuat set konteks, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Spanner Studio.

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

  5. Klik Create context set.

  6. Di Context set name, berikan nama set konteks yang unik. Di Spanner Studio, nama harus terdiri dari 4 hingga 30 karakter dan tidak boleh diawali dengan spasi kosong; Studio memperoleh ID set konteks dengan mengonversi nama menjadi huruf kecil dan mengganti karakter non-alfanumerik dengan tanda hubung (-), dan ID set konteks yang diperoleh harus unik dalam grup set konteks default project untuk region yang dipilih. Misalnya, nama set konteks querydata_e2e_test memiliki ID set konteks querydata-e2e-test. Saat Anda mengupload set konteks secara langsung menggunakan agen context engineering atau Dataplex API, ID set konteks peka huruf besar/kecil, tidak boleh berisi garis miring (/), dan tidak dibatasi hingga 4 hingga 30 karakter atau karakter alfanumerik, tanda hubung, dan garis bawah.

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

  8. Opsional. Untuk mengupload file set konteks, klik Browse di bagian Upload context set file, lalu pilih file set konteks.

  9. Opsional. Untuk memilih region bagi set konteks, klik Show Advanced Options dan pilih region di Select a location (setelan defaultnya adalah us-east1 pada setiap pembuatan). Jika Anda memilih region selain us-east1, pilih region sebelum memasukkan nama set konteks agar Spanner Studio memvalidasi keunikan nama di region tersebut.

  10. Klik Create.

Membuat set data konteks

Jika Anda membuat set konteks kosong di Studio, atau ingin memperbarui set konteks yang ada, ikuti langkah-langkah di bagian Membangun dan mengoptimalkan set konteks dengan agen context engineering untuk membuat dan mengoptimalkan file set konteks. Agen context engineering dapat membuat dan mengupload set konteks Anda langsung dari CLI, atau Anda dapat mengedit set konteks di Studio untuk mengupload file set konteks secara manual.

Mengedit set konteks

Untuk mengedit set konteks, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Spanner Studio.

  4. Klik Lihat tindakan di samping set konteks yang ingin Anda edit.

  5. Klik Edit context set.

  6. Opsional. Edit Deskripsi set data konteks.

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

  8. Klik Simpan.

Menghapus set konteks

Untuk menghapus set konteks, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud , buka halaman Spanner.

    Buka Spanner

  2. Pilih instance dari daftar, lalu pilih database.

  3. Di menu navigasi, klik Spanner Studio.

  4. Klik View actions di samping set konteks yang ingin Anda hapus.

  5. Klik Hapus set konteks.

  6. Dalam dialog konfirmasi Delete context set, masukkan ID set konteks.

  7. Klik Confirm untuk menghapus set konteks.

Langkah berikutnya