Mendapatkan detail entity dan penyimpanan data

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 collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

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:

  1. Di konsol Google Cloud , buka halaman Gemini Enterprise > Penyimpanan Data.

    Buka halaman Penyimpanan Data

  2. Klik nama penyimpanan data target Anda.

  3. Di halaman detail penyimpanan data, lihat Data store ID yang ditampilkan di header.

  4. 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_entityA dan DataConnector3_entityB).

REST

Untuk mengambil ID penyimpanan data dan entity menggunakan REST API, selesaikan langkah-langkah berikut:

  1. 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 collections untuk 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:
      • us untuk multi-region AS
      • eu untuk multi-region Uni Eropa
      • global untuk lokasi Global
      Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
    • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.

    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.

  2. 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 (seperti DataConnector3), penyimpanan data entity turunannya terdaftar di default_collection dan diawali dengan ID konektor.

    Panggil endpoint daftar dataStores di default_collection untuk 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:
      • us untuk multi-region AS
      • eu untuk multi-region Uni Eropa
      • global untuk lokasi Global
      Untuk mengetahui informasi selengkapnya, lihat Menentukan multi-region untuk penyimpanan data Anda.
    • LOCATION: multi-region penyimpanan data Anda: global, us, atau eu.

    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_entityA dan DataConnector3_entityB. Gunakan ID ini saat mengonfigurasi kontrol akses untuk semua penyimpanan data entity pokok dari penyimpanan data multi-entity menggunakan REST API.

Langkah berikutnya