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

本頁說明如何使用 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」 >「Data Stores」(資料儲存庫)。

    前往「Data Stores」(資料儲存庫) 頁面

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

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

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

REST

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

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

    如果第三方資料儲存庫有多個實體 (例如 Jira 或 Salesforce)，Gemini Enterprise 會建立專屬集合，代表連接器執行個體。呼叫 collections 清單端點，擷取專案中的集合 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：Google Cloud 專案的 ID。
    • 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：Google Cloud 專案的 ID。
    • 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。

後續步驟