获取数据存储区和实体详细信息

本页介绍了如何使用 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. 如果数据存储区包含实体，请点击实体标签页，查看已配置的实体、显示名称及其对应的实体数据存储区 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。

后续步骤