Obtén detalles del almacén de datos y la entidad

En esta página, se explica cómo recuperar los detalles de los recursos para los almacenes de datos de Gemini Enterprise y sus entidades subyacentes con la Google Cloud consola o la API de REST de Discovery Engine.

Cuando interactúas con almacenes de datos a través de APIs (por ejemplo, cuando configuras controles de acceso de IAM a nivel del recurso, consultas extremos de búsqueda o automatizas canalizaciones de transferencia), necesitas los IDs de recursos únicos de los almacenes de datos de destino y sus entidades subyacentes.

Conceptos de almacén de datos

Para comprender cómo se estructuran los recursos de almacén de datos en la API de Discovery Engine, ten en cuenta los siguientes conceptos:

Concepto Descripción
Almacén de datos Es un contenedor para los datos que se transfieren desde Google o fuentes de datos de terceros. Los almacenes de datos independientes pertenecen a la colección predeterminada (default_collection). Para obtener más información, consulta Conceptos de Gemini Enterprise y Acerca de las apps y los almacenes de datos.
Recopilación de datos Es un recurso de agrupación lógica dentro de un proyecto Google Cloud y una ubicación (projects/{project}/locations/{location}/collections/{collection}).

Los almacenes de datos externos de varias entidades (como Jira, Salesforce o SharePoint Online) crean una colección dedicada que representa la instancia del almacén de datos.
Entidad de almacén de datos Cuando conectas una fuente de datos externa que contiene varios tipos de entidades (como problemas de Jira, proyectos de Jira o archivos de SharePoint), Gemini Enterprise crea automáticamente un almacén de datos secundario independiente para cada tipo de entidad.

Estos almacenes de datos de entidades residen como recursos secundarios en collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Para obtener más información, consulta Datos estructurados para almacenes de datos de terceros y Introducción a los conectores y los almacenes de datos.

Recupera detalles del almacén de datos y la entidad

Selecciona una de las siguientes opciones:

Console

Para recuperar los detalles del almacén de datos y la entidad en la consola de Google Cloud , sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Gemini Enterprise > Almacenes de datos.

    Ir a la página Almacenes de datos.

  2. Haz clic en el nombre de tu almacén de datos de destino.

  3. En la página de detalles del almacén de datos, consulta el ID del almacén de datos que se muestra en el encabezado.

  4. Si el almacén de datos contiene entidades, haz clic en la pestaña Entidades para ver la lista de entidades configuradas, los nombres visibles y sus IDs de almacén de datos de entidades correspondientes (por ejemplo, DataConnector3_entityA y DataConnector3_entityB).

REST

Para recuperar los IDs de la entidad y del almacén de datos con la API de REST, completa los siguientes pasos:

  1. Enumera los IDs de la colección del almacén de datos (para almacenes de datos de varias entidades):

    En el caso de los almacenes de datos de terceros con varias entidades (como Jira o Salesforce), Gemini Enterprise crea una colección dedicada que representa la instancia del conector. Llama al extremo collections list para recuperar los IDs de las colecciones de tu proyecto:

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

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto deGoogle Cloud .
    • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
      • us para la multirregión de EE.UU.
      • eu para la multirregión de la UE
      • global para la ubicación global
      Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
    • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.

    La respuesta contiene la lista de colecciones:

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

    En este ejemplo, el ID de la colección es DataConnector3. Usa este ID cuando configures los controles de acceso a nivel de la colección para la instancia del conector.

  2. Enumera los IDs de almacén de datos independientes y de entidades en default_collection:

    En Gemini Enterprise, todos los recursos de almacén de datos, incluidos los almacenes de datos independientes y las entidades secundarias para los conectores de varias entidades, residen en default_collection. Aunque un almacén de datos de varias entidades tiene un ID de colección dedicado (como DataConnector3), sus almacenes de datos de entidades secundarias se registran en default_collection y tienen el prefijo del ID del conector.

    Llama al extremo de lista dataStores en default_collection para ubicar los IDs de tu almacén de datos y de la entidad:

    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"

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID de tu proyecto deGoogle Cloud .
    • ENDPOINT_LOCATION: Es la región múltiple para tu solicitud a la API. Especifica uno de los siguientes valores:
      • us para la multirregión de EE.UU.
      • eu para la multirregión de la UE
      • global para la ubicación global
      Para obtener más información, consulta Cómo especificar una región múltiple para tu almacén de datos.
    • LOCATION: Es la multirregión de tu almacén de datos: global, us o eu.

    La respuesta contiene la lista de almacenes de datos:

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

    En este ejemplo, los IDs del almacén de datos de la entidad son DataConnector3_entityA y DataConnector3_entityB. Usa estos IDs cuando configures los controles de acceso para todos los almacenes de datos de entidades subyacentes de un almacén de datos de varias entidades con la API de REST.

¿Qué sigue?