Menghubungkan ke AlloyDB untuk PostgreSQL

Dokumen ini menjelaskan cara membuat penyimpanan data yang terhubung ke data AlloyDB untuk PostgreSQL. Anda dapat menautkan penyimpanan data ini ke aplikasi Gemini Enterprise untuk mengizinkan agen menganalisis data Anda.

Untuk terhubung ke data AlloyDB untuk PostgreSQL menggunakan penyimpanan data Gemini Enterprise, Anda dapat menggunakan salah satu mode berikut:

  • Kueri gabungan (direkomendasikan) [Pratinjau]: Hubungkan ke data AlloyDB untuk PostgreSQL di tempat tanpa menimbulkan biaya keluar untuk menyalin dan memindahkan data. Kueri gabungan mengirimkan kueri Anda secara langsung ke AlloyDB untuk PostgreSQL di semua cluster, database, dan tabel yang identitas Anda memiliki izin Identity and Access Management (IAM) untuk diakses, yang lebih efisien untuk kueri analitis. Saat Anda menggunakan mode kueri gabungan, Knowledge Catalog akan otomatis diaktifkan di tab Asisten aplikasi Gemini Enterprise Anda untuk memberi agen alat guna menelusuri data yang dapat diakses pengguna dan mencari konteks.

  • Penyerapan data: Menyalin data dari tabel AlloyDB untuk PostgreSQL tertentu ke penyimpanan data Gemini Enterprise. Data harus diperbarui secara manual untuk mencerminkan perubahan pada tabel AlloyDB untuk PostgreSQL. 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 AlloyDB untuk PostgreSQL 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:

Selain itu, konfigurasi izin IAM AlloyDB untuk PostgreSQL yang diperlukan untuk mode konektor yang akan Anda gunakan:

Kueri gabungan

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

Penyerapan data

Untuk menyerap data dari project sumber Google Cloud yang berbeda dengan project Google Cloud yang berisi penyimpanan data Gemini Enterprise yang Anda buat, berikan peran Cloud AlloyDB Admin (roles/alloydb.admin) di project AlloyDB untuk PostgreSQL sumber ke akun layanan service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com (dengan PROJECT_NUMBER adalah nomor projectGoogle Cloud yang berisi penyimpanan data Gemini Enterprise).

Membuat penyimpanan data AlloyDB untuk PostgreSQL

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

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

    Gemini Enterprise

  2. Buka halaman Data stores.

  3. Klik Buat penyimpanan data.

  4. Di halaman Sumber, pilih sumber data untuk penyimpanan data Anda. Telusuri "AlloyDB untuk PostgreSQL" di kolom penelusuran Pilih sumber data, atau temukan AlloyDB untuk PostgreSQL dalam daftar Sumber data pihak pertama. Pilih Tambahkan sumber data.

  5. 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

    1. Pilih Kueri gabungan (direkomendasikan). Klik Continue.
    2. Di halaman Actions, pilih tindakan AlloyDB untuk PostgreSQL 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 Impor data dari tabel AlloyDB untuk PostgreSQL Anda, tentukan informasi berikut:
      • Project ID: Google Cloud Project yang berisi tabel AlloyDB untuk PostgreSQL. Kolom ini wajib diisi.
      • ID Lokasi: ID lokasi AlloyDB untuk PostgreSQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • ID Cluster: ID cluster AlloyDB untuk PostgreSQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • ID Database: ID database AlloyDB untuk PostgreSQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • ID Tabel: ID tabel AlloyDB untuk PostgreSQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
    3. Klik Lanjutkan.

  6. 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.

  7. Klik Create.

Sekarang Anda siap melampirkan penyimpanan data ke aplikasi Gemini Enterprise. Dalam mode kueri gabungan, kueri menimbulkan biaya penggunaan AlloyDB untuk PostgreSQL saat pengguna menjalankan kueri melalui aplikasi yang dilampirkan; dalam mode penyerapan data, mengimpor data menimbulkan biaya pengindeksan AlloyDB untuk PostgreSQL dan Gemini Enterprise bahkan sebelum penyimpanan data dilampirkan ke aplikasi. Untuk mempelajari lebih lanjut biaya ini, lihat harga Gemini Enterprise.

Langkah berikutnya