Halaman ini menjelaskan cara mengambil detail resource untuk penyimpanan data Gemini Enterprise dan entity yang mendasarinya menggunakan konsol Google Cloud atau Discovery Engine REST API.
Saat Anda berinteraksi dengan penyimpanan data menggunakan API—seperti mengonfigurasi kontrol akses IAM tingkat resource, membuat kueri endpoint penelusuran, atau mengotomatiskan pipeline penyerapan—Anda memerlukan ID resource unik dari penyimpanan data target dan entity yang mendasarinya.
Konsep penyimpanan data
Untuk memahami cara resource penyimpanan data disusun dalam Discovery Engine API, pertimbangkan konsep berikut:
| Konsep | Deskripsi |
|---|---|
| Penyimpanan data |
Penampung untuk data yang diserap dari sumber data Google atau pihak ketiga. Penyimpanan data mandiri termasuk dalam koleksi default
(default_collection). Untuk mengetahui informasi selengkapnya, lihat
Konsep Gemini Enterprise
dan Tentang aplikasi dan penyimpanan data.
|
| Pengumpulan data |
Resource pengelompokan logis dalam project dan lokasi Google Cloud (projects/{project}/locations/{location}/collections/{collection}).
Penyimpanan data pihak ketiga multi-entity (seperti Jira, Salesforce, atau SharePoint Online) membuat koleksi khusus yang mewakili instance penyimpanan data. |
| Entitas penyimpanan data |
Saat Anda menghubungkan sumber data pihak ketiga yang berisi beberapa
jenis entity (seperti masalah Jira, project Jira, atau file
SharePoint), Gemini Enterprise akan otomatis membuat penyimpanan data turunan
terpisah untuk setiap jenis entity.
Penyimpanan data entity ini berada sebagai resource turunan di bawah
Untuk mengetahui informasi selengkapnya, lihat Data terstruktur untuk penyimpanan data pihak ketiga dan Pengantar konektor dan penyimpanan data. |
Mengambil detail penyimpanan data dan entity
Pilih salah satu opsi berikut:
Konsol
Untuk mengambil detail penyimpanan data dan entity di konsol Google Cloud , ikuti langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise > Penyimpanan Data.
Klik nama penyimpanan data target Anda.
Di halaman detail penyimpanan data, lihat Data store ID yang ditampilkan di header.
Jika penyimpanan data berisi entity, klik tab Entities untuk melihat daftar entity yang dikonfigurasi, nama tampilan, dan ID penyimpanan data entity yang sesuai (misalnya,
DataConnector3_entityAdanDataConnector3_entityB).
REST
Untuk mengambil ID penyimpanan data dan entity menggunakan REST API, selesaikan langkah-langkah berikut:
Mencantumkan ID koleksi penyimpanan data (untuk penyimpanan data multi-entity):
Untuk penyimpanan data pihak ketiga dengan beberapa entity (seperti Jira atau Salesforce), Gemini Enterprise membuat koleksi khusus yang mewakili instance konektor. Panggil endpoint daftar
collectionsuntuk mengambil ID koleksi di project Anda:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"Ganti kode berikut:
PROJECT_ID: ID project Google Cloud Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueu.
Responsnya berisi daftar koleksi:
{ "collections": [ { "name": "projects/123456789/locations/global/collections/DataConnector3", "displayName": "Jira Production Data Store" } ] }Dalam contoh ini, ID koleksinya adalah
DataConnector3. Gunakan ID ini saat mengonfigurasi kontrol akses tingkat koleksi untuk instance konektor.Cantumkan ID entity dan penyimpanan data mandiri di bagian
default_collection:Di Gemini Enterprise, semua resource penyimpanan data, termasuk penyimpanan data mandiri dan entity turunan untuk konektor multi-entity, berada di bagian
default_collection. Meskipun penyimpanan data multi-entity memiliki ID koleksi khusus (sepertiDataConnector3), penyimpanan data entity turunannya terdaftar didefault_collectiondan diawali dengan ID konektor.Panggil endpoint daftar
dataStoresdidefault_collectionuntuk menemukan ID entity dan penyimpanan data Anda:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"Ganti kode berikut:
PROJECT_ID: ID project Google Cloud Anda.ENDPOINT_LOCATION: multi-region untuk permintaan API Anda. Tentukan salah satu nilai berikut:usuntuk multi-region ASeuuntuk multi-region Uni Eropaglobaluntuk lokasi Global
LOCATION: multi-region penyimpanan data Anda:global,us, ataueu.
Responsnya berisi daftar penyimpanan data:
{ "dataStores": [ { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA", "displayName": "Jira Issues Entity" }, { "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB", "displayName": "Jira Projects Entity" } ] }Dalam contoh ini, ID penyimpanan data entity adalah
DataConnector3_entityAdanDataConnector3_entityB. Gunakan ID ini saat mengonfigurasi kontrol akses untuk semua penyimpanan data entity pokok dari penyimpanan data multi-entity menggunakan REST API.
Langkah berikutnya
- Mengonfigurasi kontrol akses terperinci untuk aplikasi dan penyimpanan data
- Referensi REST API Discovery Engine