Menghubungkan ke BigQuery

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

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

• Kueri gabungan (direkomendasikan) [Pratinjau]: Hubungkan ke data BigQuery di tempat tanpa menimbulkan biaya keluar untuk menyalin dan memindahkan data. Kueri gabungan mengirimkan kueri Anda secara langsung ke BigQuery di semua set data dan tabel yang identitas Anda memiliki izin Identity and Access Management (IAM) untuk mengaksesnya, yang lebih efisien untuk kueri analitis. Karena kueri dijalankan menggunakan kredensial Anda, izin IAM BigQuery, termasuk keamanan tingkat baris, tetap utuh. 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 BigQuery tertentu ke penyimpanan data Gemini Enterprise. Data harus dimuat ulang untuk mencerminkan perubahan pada tabel BigQuery. Mode ini menimbulkan biaya keluar untuk memindahkan data ke lokasi baru, dan izin IAM yang ada tidak direplikasi ke penyimpanan data.

Sebelum memulai

Untuk membuat penyimpanan data BigQuery 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 bigquery_mcp 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, konfigurasikan izin IAM BigQuery yang diperlukan untuk mode konektor yang akan 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.

Mode kueri gabungan menggunakan server BigQuery MCP. Karena alat MCP (tindakan) yang berbeda memerlukan izin yang berbeda, izin IAM yang diperlukan bergantung pada alat yang Anda gunakan. Untuk mengetahui informasi selengkapnya, lihat Peran yang diperlukan dalam dokumentasi MCP BigQuery.

Berikut adalah peran IAM yang paling umum diterapkan untuk pengguna yang membuat kueri atau melakukan tindakan melalui konektor:

• Pengguna Tugas BigQuery (roles/bigquery.jobUser) di project BigQuery Google Cloud tempat kueri dijalankan (project komputasi atau penagihan), untuk memberi pengguna kemampuan menjalankan tugas kueri.
• BigQuery Data Viewer (roles/bigquery.dataViewer) di project BigQuery Google Cloud tempat data disimpan (project penyimpanan), untuk memberi pengguna kemampuan mengakses data dalam kueri atau melalui alat metadata BigQuery seperti get_table_info. Jika tindakan tulis diaktifkan, berikan BigQuery Data Editor (roles/bigquery.dataEditor) sebagai gantinya.
• Pengguna Alat MCP (roles/mcp.toolUser) di project penyimpanan BigQuery Google Cloud dan project Google Cloud komputasi.

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 peran IAM berikut di project BigQuery sumber ke akun [e-mail] (dengan PROJECT_NUMBER adalah nomor project dari projectGoogle Cloud yang berisi penyimpanan data Gemini Enterprise):

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Data Editor (roles/bigquery.dataEditor)

Perhatian: Jika Anda memilih untuk menyerahkan data dari BigQuery ke penyimpanan data Gemini Enterprise, izin BigQuery 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 BigQuery.

Membuat penyimpanan data BigQuery

Untuk membuat penyimpanan data yang menghubungkan data dari BigQuery 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 "BigQuery" di kolom penelusuran Pilih sumber data, atau temukan BigQuery 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).
   2. Secara opsional, di bagian Opsi lanjutan, tentukan Google Cloud project penagihan untuk eksekusi kueri penyimpanan data Anda dengan mengetikkan project ID ke dalam kolom Project ID Penagihan. Jika Anda mengosongkan kolom ini, kueri akan meminta pengguna untuk memilih project penagihan atau mengandalkan petunjuk kustom.
   3. Klik Lanjutkan.
   4. Di halaman Tindakan, pilih tindakan BigQuery yang ingin Anda aktifkan untuk penyimpanan data. Anda dapat mengedit setelan ini nanti. Klik Continue.

   Penyerapan data

   1. Pilih Penyerapan data.
   2. Tentukan jenis data yang Anda impor. Sebelum mengimpor data, tinjau Menyiapkan data untuk penyerapan.
      • Jika Anda mengimpor data terstruktur, pilih dari Tabel BigQuery dengan skema Anda sendiri atau Tabel BigQuery dengan metadata. Jika menggunakan skema Anda sendiri, skema Anda akan terdeteksi secara otomatis selama impor. Jika menggunakan metadata, Anda harus menentukan skema yang ditentukan Google selama impor.
      • Jika Anda mengimpor data yang memerlukan pemrosesan khusus, pilih dari opsi di bagian Specialized Data Import.

   3. Di bagian Frekuensi sinkronisasi, pilih seberapa sering Anda ingin mengimpor data dari tabel BigQuery. Opsi ini tidak dapat diubah setelah penyimpanan data dibuat.

      • Pilih Satu kali untuk impor tunggal.
      • Pilih Berkala untuk menyetel jadwal impor berulang.

   4. Pilih tabel data yang ingin Anda impor. Di kolom BigQuery path, klik Browse, pilih tabel yang telah disiapkan untuk penyerapan, lalu klik Select. Atau, masukkan lokasi tabel langsung di kolom jalur BigQuery.

   5. Klik Lanjutkan.

   Setelah membuat penyimpanan data, Anda dapat memeriksa status penyerapan dengan membuka halaman Penyimpanan data dan mengklik nama penyimpanan data untuk melihat detailnya di halaman Data. Saat kolom status di tab Aktivitas berubah dari Sedang berlangsung menjadi Impor selesai, penyerapan selesai.

   Bergantung pada ukuran data Anda, penyerapan dapat memerlukan waktu beberapa menit hingga beberapa jam.

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 komputasi BigQuery saat pengguna menjalankan kueri melalui aplikasi yang dilampirkan; dalam mode penyerapan data, mengimpor data menimbulkan biaya pengindeksan BigQuery 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 cakupan dengan kueri terverifikasi di BigQuery, lihat Memublikasikan agen data BigQuery ke Gemini Enterprise.