Dokumen ini menjelaskan cara membuat penyimpanan data yang terhubung ke data Spanner. Anda dapat menautkan penyimpanan data ini ke aplikasi Gemini Enterprise untuk mengizinkan agen menganalisis data Anda.
Untuk terhubung ke data Spanner menggunakan penyimpanan data Gemini Enterprise, Anda dapat menggunakan salah satu mode berikut:
Kueri gabungan (direkomendasikan) [Pratinjau]: Hubungkan ke data Spanner di tempat tanpa menimbulkan biaya keluar untuk menyalin dan memindahkan data. Kueri gabungan mengirimkan kueri Anda secara langsung ke Spanner di semua database dan tabel yang identitas Anda memiliki izin Identity and Access Management (IAM) untuk mengaksesnya, yang lebih efisien untuk kueri analitis. Saat Anda menggunakan mode kueri gabungan, Knowledge Catalog diaktifkan secara otomatis di tab Asisten aplikasi Gemini Enterprise Anda untuk memberi agen alat guna menelusuri data yang dapat diakses pengguna dan mencari konteks.
Penyerapan data: Salin data dari tabel Spanner tertentu ke penyimpanan data Gemini Enterprise. Data harus dimuat ulang secara manual untuk mencerminkan perubahan pada tabel Spanner. Mode ini menimbulkan biaya traffic keluar untuk memindahkan data ke lokasi baru, dan izin IAM yang ada tidak direplikasi ke penyimpanan data.
Sebelum memulai
Untuk membuat penyimpanan data Spanner di Gemini Enterprise, Anda harus memiliki peran Admin Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) atau Admin Discovery Engine (roles/discoveryengine.admin). Untuk mengetahui informasi selengkapnya, lihat
Memberikan izin kepada admin.
Jika project Anda dilindungi oleh perimeter Kontrol Layanan VPC atau mengaktifkan penerapan kebijakan organisasi, pastikan kebijakan organisasi Anda mengizinkan konektor:
- Tambahkan
spannerke parameterallowedDataSourcesdalam batasan yang dikeloladiscoveryengine.managed.allowedDataSources(Membatasi sumber data yang diizinkan untuk konektor data). Untuk mengetahui informasi selengkapnya, lihat Ringkasan batasan kebijakan terkelola dan Mengonfigurasi sumber data yang diizinkan.
Selain itu, konfigurasikan izin IAM Spanner yang diperlukan untuk mode konektor yang akan Anda gunakan:
Kueri gabungan
Untuk terhubung ke Spanner menggunakan mode kueri gabungan, berikan peran IAM berikut kepada pengguna yang membuat kueri atau melakukan tindakan melalui konektor di projectGoogle Cloud yang berisi database Spanner Anda:
- Akses database:
- Pembaca Database Cloud Spanner (
roles/spanner.databaseReader) untuk kueri dan alat hanya baca. - Pengguna Database Cloud Spanner (
roles/spanner.databaseUser) atau Admin Database Cloud Spanner (roles/spanner.databaseAdmin) jika tindakan penulisan atau DDL diaktifkan.
- Pembaca Database Cloud Spanner (
- Akses alat MCP:
- Pengguna Alat MCP (
roles/mcp.toolUser) di project tempat database Spanner berada untuk memanggil alat MCP Spanner.
- Pengguna Alat MCP (
Penyerapan data
Untuk memasukkan data dari project sumber Google Cloud yang
berbeda dengan project Google Cloud yang berisi penyimpanan data Gemini Enterprise yang Anda buat, berikan salah satu peran IAM berikut di project Spanner sumber ke akun layananservice-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com (dengan PROJECT_NUMBER adalah nomor project dari projectGoogle Cloud yang berisi penyimpanan data Gemini Enterprise):
- Tanpa Data Boost:
Cloud Spanner Database Reader (
roles/spanner.databaseReader) - Dengan Data Boost:
Cloud Spanner Database Admin (
roles/spanner.databaseAdmin), atau peran kustom dengan izin Cloud Spanner Database Reader danspanner.databases.useDataBoost. Untuk mengetahui informasi selengkapnya, lihat Ringkasan Data Boost.
Membuat penyimpanan data Spanner
Untuk membuat penyimpanan data yang menghubungkan data dari Spanner ke Gemini Enterprise, ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Buka halaman Data stores.
Klik Buat penyimpanan data.
Di halaman Sumber, pilih sumber data untuk penyimpanan data Anda. Telusuri "Spanner" di kolom penelusuran Pilih sumber data, atau temukan Spanner dalam daftar Sumber data pihak pertama. Pilih Tambahkan sumber data.
Di halaman Data, pilih mode konektor untuk cara menghubungkan ke data Anda. Pilih dari tab berikut untuk mengetahui petunjuk lebih lanjut berdasarkan mode yang telah Anda pilih.
Kueri gabungan
Penyerapan data
- Pilih Penyerapan data.
Tentukan detail tentang data yang ingin Anda impor. Di bagian Impor data dari tabel Spanner Anda, tentukan informasi berikut:
- Project ID: Project Google Cloud yang berisi tabel Spanner. Kolom ini wajib diisi.
- ID Instance: ID instance Spanner yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
- ID Database: ID database Spanner yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
- ID Tabel: ID tabel Spanner yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
Secara opsional, pilih Aktifkan Data Boost untuk menggunakan Spanner Data Boost agar kueri lebih cepat. Mengaktifkan Data Boost akan menimbulkan biaya tambahan. Lihat Penagihan dan Kuota Spanner Data Boost.
Klik Lanjutkan.
Di halaman Configuration, konfigurasi setelan penyimpanan data Anda.
- Lokasi konektor data Anda: Pilih region tempat metadata penyimpanan data Anda akan disimpan. Anda tidak dapat mengubah lokasi setelah penyimpanan data dibuat. Untuk mengetahui informasi penting tentang multi-region, lihat Lokasi Gemini Enterprise.
- Nama konektor data Anda: Di kolom Nama konektor data, masukkan nama untuk konektor data Anda. Anda tidak dapat mengubah nama setelah konektor data dibuat. Memasukkan nama akan menghasilkan ID unik untuk konektor data Anda. Secara opsional, di kolom Tag (opsional), masukkan tag untuk konektor data Anda, yang berfungsi sebagai ID stabil untuk konektor di semua versi.
- Kebijakan perlindungan data sensitif: Pilih
kebijakan perlindungan data sensitif
untuk penyimpanan data Anda. Formatnya harus mengikuti:
projects/{project}/locations/{location}/contentPolicies/{policy}. Anda dapat mengedit setelan ini nanti.
Klik Create.
Sekarang Anda siap melampirkan penyimpanan data ke aplikasi Gemini Enterprise. Dalam mode kueri gabungan, kueri menimbulkan biaya penggunaan Spanner saat pengguna menjalankan kueri melalui aplikasi yang dilampirkan; dalam mode penyerapan data, mengimpor data menimbulkan biaya pengindeksan Spanner dan Gemini Enterprise bahkan sebelum penyimpanan data dilampirkan ke aplikasi. Untuk mempelajari lebih lanjut biaya ini, lihat Harga Gemini Enterprise.
Langkah berikutnya
Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi Gemini Enterprise.
Pelajari cara Knowledge Catalog bekerja dengan konektor Data Cloud (diaktifkan secara otomatis saat Anda menggunakan mode kueri gabungan) untuk membantu agen menelusuri data yang dapat diakses pengguna dan mencari konteks organisasi.
Untuk membuat agen dalam cakupan dengan akurasi tinggi dan kueri terverifikasi, lihat Memublikasikan agen data Spanner ke Gemini Enterprise.