Menghubungkan ke Spanner

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]: Terhubung ke data Spanner di tempat tanpa menimbulkan biaya keluar untuk menyalin dan memindahkan data. Kueri gabungan mengirimkan kueri Anda langsung ke Spanner di semua database dan tabel yang memiliki izin Identity and Access Management (IAM) untuk diakses oleh identitas Anda, yang lebih efisien untuk kueri analisis. Saat Anda menggunakan mode kueri gabungan, Knowledge Catalog akan otomatis diaktifkan di tab Assistant aplikasi Gemini Enterprise 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 dalam tabel Spanner. Mode ini menimbulkan biaya keluar untuk memindahkan data ke lokasi baru, dan izin IAM yang ada tidak direplikasi ke dalam penyimpanan data.

Sebelum memulai

Untuk membuat penyimpanan data Spanner di Gemini Enterprise, Anda harus memiliki Admin Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) atau Admin Discovery Engine (roles/discoveryengine.admin) peran. Untuk mengetahui informasi selengkapnya, lihat Memberikan izin kepada admin.

Jika project Anda dilindungi oleh perimeter Kontrol Layanan VPC atau memiliki penerapan kebijakan organisasi yang diaktifkan, pastikan kebijakan organisasi Anda mengizinkan konektor:

Selain itu, konfigurasikan izin IAM Spanner yang diperlukan untuk mode konektor yang akan Anda gunakan:

Kueri gabungan

Untuk terhubung ke Spanner menggunakan kueri gabungan mode, berikan peran IAM berikut kepada pengguna yang membuat kueri atau melakukan tindakan melalui konektor di Google Cloud project yang berisi database Spanner Anda:

Penyerapan data

Untuk menyerap data dari source Google Cloud project yang's berbeda dari Google Cloud project yang berisi penyimpanan data Gemini Enterprise store yang Anda buat, berikan salah satu peran IAM berikut di project Spanner sumber ke service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com akun layanan (dengan PROJECT_NUMBER adalah nomor project dari Google Cloud project yang berisi penyimpanan data Gemini Enterprise):

Membuat penyimpanan data Spanner

Untuk membuat penyimpanan data yang menghubungkan data dari Spanner ke Gemini Enterprise, ikuti langkah-langkah berikut:

  1. Di Google Cloud konsol, buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Buka halaman Data stores.

  3. Klik Buat penyimpanan data.

  4. Di halaman Source, pilih sumber data untuk penyimpanan data Anda. Telusuri "Spanner" di kolom penelusuran Select a data source, atau temukan Spanner dalam daftar First-party data sources. Pilih Add data source.

  5. Di halaman Data, pilih mode konektor untuk cara terhubung ke data Anda. Pilih dari tab berikut untuk mengetahui petunjuk lebih lanjut berdasarkan mode yang telah Anda pilih.

    Kueri gabungan

    1. Pilih Kueri gabungan (direkomendasikan). Klik Continue.
    2. Di halaman Actions, pilih tindakan Spanner yang ingin Anda aktifkan untuk penyimpanan data Anda. Anda dapat mengedit setelan ini nanti. Klik Continue.

    Penyerapan data

    1. Pilih Penyerapan data.

    2. Tentukan detail tentang data yang ingin Anda impor. Di bagian Import data from your Spanner table, tentukan informasi berikut:

      • Project ID: The Google Cloud project yang berisi tabel Spanner. Kolom ini wajib diisi.
      • Instance ID: 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 Enable Data Boost untuk menggunakan Spanner Data Boost guna mempercepat kueri. Mengaktifkan Data Boost akan menimbulkan biaya tambahan. Lihat Harga Spanner Data Boost.

    3. Klik Continue.

  6. Di halaman Configuration, konfigurasikan setelan penyimpanan data Anda.

    • Lokasi konektor data Anda: Pilih region untuk tempat menyimpan metadata penyimpanan data Anda. Anda tidak dapat mengubah lokasi setelah penyimpanan data dibuat. Untuk mengetahui informasi penting tentang multi-region, lihat Lokasi Gemini Enterprise.
    • Your data connector name: Di kolom Data connector name, 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 (optional), 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.

  7. Klik Create.

Sekarang Anda siap melampirkan penyimpanan data ke aplikasi Gemini Enterprise. Dalam mode kueri gabungan, kueri akan dikenai biaya penggunaan Spanner saat pengguna menjalankan kueri melalui aplikasi terlampir; dalam mode penyerapan data, mengimpor data akan dikenai 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