Sambungkan ke Cloud SQL

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

Untuk terhubung ke data Cloud SQL menggunakan penyimpanan data Gemini Enterprise, Anda dapat menggunakan salah satu mode berikut:

• Kueri gabungan (direkomendasikan) [Pratinjau]: Terhubung ke data Cloud SQL di tempat tanpa menimbulkan biaya keluar untuk menyalin dan memindahkan data. Kueri gabungan mengirim kueri Anda langsung ke Cloud SQL di semua instance, 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 diaktifkan secara otomatis di tab Asisten aplikasi Gemini Enterprise Anda untuk memberi agen alat guna menelusuri data yang dapat diakses pengguna dan mencari konteks.

  Perhatian: Kueri database dengan akurasi tinggi: Mode kueri gabungan memberikan akses luas ke semua instance dan database yang dapat diakses oleh pengguna, tetapi akurasi kueri dapat bervariasi pada skema transaksional yang kompleks. Untuk workload yang memerlukan akurasi tinggi, cakupan tabel deterministik, dan kueri terverifikasi (SQL standar), buat agen data tercakup di Cloud SQL untuk MySQL atau Cloud SQL untuk PostgreSQL, lalu publikasikan ke Gemini Enterprise.

• Penyerapan data: Salin data dari tabel Cloud SQL tertentu ke penyimpanan data Gemini Enterprise. Data harus diperbarui secara manual untuk mencerminkan perubahan dalam tabel Cloud SQL. 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 Cloud SQL 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 cloudsql ke parameter allowedDataSources dalam batasan yang dikelola discoveryengine.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, selesaikan prasyarat dan konfigurasi izin IAM Cloud SQL yang diperlukan untuk mode konektor yang ingin Anda gunakan:

Kueri gabungan

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk terhubung ke Cloud SQL menggunakan mode kueri gabungan, selesaikan prasyarat berikut di Google Cloud project yang berisi instance Cloud SQL Anda:

1. Aktifkan Data API di instance Cloud SQL Anda:

   gcloud sql instances patch <var>INSTANCE_NAME</var> \
       --project=<var>PROJECT_ID</var> \
       --data-api-access=ALLOW_DATA_API
   

2. Memberi izin IAM: Beri peran IAM berikut di project Google Cloud yang berisi instance Cloud SQL Anda kepada pengguna yang membuat kueri atau melakukan tindakan melalui konektor:

   • Akses instance dan database:
     • Cloud SQL Viewer (roles/cloudsql.viewer) dan Cloud SQL Client (roles/cloudsql.client) (atau Cloud SQL Instance User (roles/cloudsql.instanceUser) dengan autentikasi database IAM) untuk kueri dan alat hanya baca.
     • Editor Cloud SQL (roles/cloudsql.editor) atau Admin Cloud SQL (roles/cloudsql.admin) jika tindakan tulis atau administratif diaktifkan.
   • Akses alat MCP:
     • Izin Pengguna Alat MCP (roles/mcp.toolUser) di project tempat instance Cloud SQL berada untuk memanggil alat MCP.

Penyerapan data

Untuk memasukkan data dari Cloud SQL, konfigurasi izin IAM berikut:

• Akses bucket staging: Saat menyerap data dari Cloud SQL, data pertama-tama di-staging ke bucket Cloud Storage. Berikan peran Storage Admin (roles/storage.admin) di bucket Cloud Storage perantara ke akun layanan instance Cloud SQL Anda (misalnya, [e-mail]).
• Akses Cloud SQL lintas project: Jika Anda mengimpor data dari project Google Cloud sumber yang berbeda dengan project Google Cloud yang berisi penyimpanan data Gemini Enterprise yang Anda buat, berikan peran Cloud SQL Viewer (roles/cloudsql.viewer) di project Cloud SQL sumber ke akun layanan [e-mail] (dengan PROJECT_NUMBER adalah nomor project dari projectGoogle Cloud yang berisi penyimpanan data Gemini Enterprise).

Perhatian: Jika Anda memilih untuk memasukkan data dari Cloud SQL ke penyimpanan data Gemini Enterprise, izin Cloud SQL tidak diimpor bersama data. Setelah diimpor, setiap pengguna dengan izin Gemini Enterprise yang memadai dapat melihat data, meskipun mereka tidak memiliki izin untuk melihat data di Cloud SQL.

Membuat penyimpanan data Cloud SQL

Untuk membuat penyimpanan data yang menghubungkan data dari Cloud SQL 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 "Cloud SQL" di kolom penelusuran Pilih sumber data, atau temukan Cloud SQL 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

   Pratinjau

   Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

   1. Pilih Kueri gabungan (direkomendasikan). Klik Continue.
   2. Di halaman Tindakan, pilih tindakan Cloud SQL 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 Cloud SQL Anda, tentukan informasi berikut:
      • Project ID: Project Google Cloud yang berisi tabel Cloud SQL. Kolom ini wajib diisi.
      • ID Instance: ID instance Cloud SQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • ID Database: ID database Cloud SQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • ID Tabel: ID tabel Cloud SQL yang berisi data yang ingin Anda impor. Kolom ini wajib diisi.
      • Masukkan lokasi bucket Google Cloud Storage untuk data. Kolom ini wajib diisi. Secara opsional, pilih Aktifkan ekspor serverless untuk menggunakan ekspor serverless Cloud SQL. Mengaktifkan ekspor serverless akan menimbulkan biaya tambahan. Lihat harga ekspor serverless Cloud SQL.
   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 Cloud SQL saat pengguna menjalankan kueri melalui aplikasi yang dilampirkan; dalam mode penyerapan data, mengimpor data menimbulkan biaya pengindeksan Cloud SQL, Cloud Storage, 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 Cloud SQL untuk MySQL atau Agen data Cloud SQL untuk PostgreSQL ke Gemini Enterprise.