取得資料儲存庫和實體詳細資料

本頁說明如何使用 Google Cloud 控制台或 Discovery Engine REST API，擷取 Gemini Enterprise 資料儲存庫及其基礎實體的資源詳細資料。

使用 API 與資料儲存庫互動時 (例如設定資源層級 IAM 存取控管機制、查詢搜尋端點或自動執行擷取管道)，您需要目標資料儲存庫及其基礎實體的專屬資源 ID。

資料儲存庫概念

如要瞭解 Discovery Engine API 中的資料儲存庫資源結構，請參考下列概念：

概念 說明
資料儲存庫 容器，用於存放從 Google 或第三方資料來源擷取的資料。獨立資料儲存庫屬於預設集合 (default_collection)。詳情請參閱「Gemini Enterprise 概念」和「關於應用程式和資料儲存庫」。
資料收集 專案 Google Cloud 和位置 (projects/{project}/locations/{location}/collections/{collection}) 內的邏輯分組資源。

多實體第三方資料儲存庫 (例如 Jira、Salesforce 或 SharePoint Online) 會建立專屬的集合，代表資料儲存庫執行個體。
資料儲存庫實體 連結含有多個實體類型 (例如 Jira 問題、Jira 專案或 SharePoint 檔案) 的第三方資料來源時，Gemini Enterprise 會自動為每個實體類型建立個別的子資料儲存庫。

這些實體資料儲存庫位於 collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID} 下方，屬於子資源。

詳情請參閱「第三方資料儲存庫的結構化資料」和「連接器和資料儲存庫簡介」。

擷取資料儲存庫和實體詳細資料

選取下列選項之一：

控制台

如要在 Google Cloud 控制台中擷取資料儲存庫和實體詳細資料，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」>「資料儲存庫」頁面。

    前往「資料儲存庫」頁面

  2. 點按目標資料儲存庫的名稱。

  3. 在資料儲存庫詳細資料頁面中，查看標題中顯示的「資料儲存庫 ID」。

  4. 如果資料儲存庫包含實體，請點按「Entities」(實體) 分頁標籤，查看已設定的實體清單、顯示名稱，以及對應的實體資料儲存庫 ID (例如 DataConnector3_entityA 和 DataConnector3_entityB)。

REST

如要使用 REST API 擷取資料儲存庫和實體 ID，請完成下列步驟：

  1. 列出資料儲存庫集合 ID (適用於多實體資料儲存庫)：

    如果是具有多個實體的第三方資料儲存庫 (例如 Jira 或 Salesforce)，Gemini Enterprise 會建立代表連接器執行個體的專屬集合。呼叫 collections list 端點，擷取專案中的集合 ID：

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"

    更改下列內容：

    • PROJECT_ID：專案的 ID。Google Cloud
    • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
      • us 適用於美國多區域
      • eu 代表歐盟多區域
      • global 適用於全域位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION：資料儲存庫的多區域：global、us 或 eu。

    回覆會列出集合：

    {
  "collections": [
    {
      "name": "projects/123456789/locations/global/collections/DataConnector3",
      "displayName": "Jira Production Data Store"
    }
  ]
}

    在本例中，集合 ID 為 DataConnector3。為連接器執行個體設定集合層級存取控管機制時，請使用這個 ID。

  2. 在 default_collection 下方列出實體和獨立資料儲存庫 ID：

    在 Gemini Enterprise 中，所有資料儲存庫資源 (包括獨立資料儲存庫和多實體連接器的子實體) 都位於 default_collection 下方。即使多實體資料儲存庫有專屬的集合 ID (例如 DataConnector3)，其子實體資料儲存庫仍會註冊在 default_collection 下，並以連接器 ID 為前置字元。

    在 default_collection 上呼叫 dataStores 清單端點，找出資料儲存庫和實體 ID：

    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"

    更改下列內容：

    • PROJECT_ID：專案的 ID。Google Cloud
    • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
      • us 適用於美國多區域
      • eu 代表歐盟多區域
      • global 適用於全域位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION：資料儲存庫的多區域：global、us 或 eu。

    回應包含資料儲存庫清單：

    {
  "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"
    }
  ]
}

    在本範例中，實體資料儲存庫 ID 為 DataConnector3_entityA 和 DataConnector3_entityB。使用 REST API 為多實體資料儲存庫的所有基礎實體資料儲存庫設定存取控制項時，請使用這些 ID。

後續步驟