Obtenir les détails d'un data store et d'une entité

Cette page explique comment récupérer les détails des ressources pour les data stores Gemini Enterprise et leurs entités sous-jacentes à l'aide de la console Google Cloud ou de l'API REST Discovery Engine.

Lorsque vous interagissez avec des datastores à l'aide d'API (par exemple, pour configurer des contrôles d'accès IAM au niveau des ressources, interroger des points de terminaison de recherche ou automatiser des pipelines d'ingestion), vous avez besoin des ID de ressources uniques des datastores cibles et de leurs entités sous-jacentes.

Concepts de datastore

Pour comprendre la structure des ressources du data store dans l'API Discovery Engine, tenez compte des concepts suivants :

Concept Description
Datastore Conteneur pour les données ingérées à partir de sources de données Google ou tierces. Les datastores autonomes appartiennent à la collection par défaut (default_collection). Pour en savoir plus, consultez Concepts Gemini Enterprise et À propos des applications et des datastores.
Collecte de données Ressource de regroupement logique dans un projet Google Cloud et un emplacement projects/{project}/locations/{location}/collections/{collection}.

Les datastores tiers multi-entités (tels que Jira, Salesforce ou SharePoint Online) créent une collection dédiée représentant l'instance du data store.
Entité de datastore Lorsque vous connectez une source de données tierce contenant plusieurs types d'entités (tels que des problèmes Jira, des projets Jira ou des fichiers SharePoint), Gemini Enterprise crée automatiquement un data store enfant distinct pour chaque type d'entité.

Ces magasins de données d'entités résident en tant que ressources enfants sous collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Pour en savoir plus, consultez Données structurées pour les data stores tiers et Présentation des connecteurs et des data stores.

Récupérer les détails du data store et de l'entité

Sélectionnez l'une des options suivantes :

Console

Pour récupérer les détails du data store et de l'entité dans la console Google Cloud , procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise > Datastores.

    Accéder à la page "Datastores"

  2. Cliquez sur le nom de votre data store cible.

  3. Sur la page d'informations du data store, consultez l'ID du datastore affiché dans l'en-tête.

  4. Si le data store contient des entités, cliquez sur l'onglet Entités pour afficher la liste des entités configurées, les noms à afficher et les ID de data store d'entité correspondants (par exemple, DataConnector3_entityA et DataConnector3_entityB).

REST

Pour récupérer les ID de data store et d'entité à l'aide de l'API REST, procédez comme suit :

  1. Répertoriez les ID de collections de data store (pour les datastores multi-entités) :

    Pour les datastores tiers comportant plusieurs entités (comme Jira ou Salesforce), Gemini Enterprise crée une collection dédiée représentant l'instance du connecteur. Appelez le point de terminaison collections list pour récupérer les ID de collection de votre projet :

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

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projetGoogle Cloud .
    • ENDPOINT_LOCATION : région multiple pour votre requête API. Spécifiez l'une des valeurs suivantes :
      • us pour l'emplacement multirégional US
      • eu pour l'emplacement multirégional EU
      • global pour l'emplacement mondial
      Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
    • LOCATION : emplacement multirégional de votre data store : global, us ou eu.

    La réponse contient la liste des collections :

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

    Dans cet exemple, l'ID de la collection est DataConnector3. Utilisez cet ID lorsque vous configurez des contrôles des accès au niveau de la collecte pour l'instance du connecteur.

  2. Listez les ID d'entités et de data store autonomes sous default_collection :

    Dans Gemini Enterprise, toutes les ressources de data store, y compris les datastores autonomes et les entités enfants pour les connecteurs multi-entités, se trouvent sous default_collection. Même si un data store multi-entités possède un ID de collection dédié (tel que DataConnector3), ses datastores d'entités enfants sont enregistrés sous default_collection et précédés de l'ID du connecteur.

    Appelez le point de terminaison de la liste dataStores sur default_collection pour localiser vos ID de data store et d'entité :

    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"

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projetGoogle Cloud .
    • ENDPOINT_LOCATION : région multiple pour votre requête API. Spécifiez l'une des valeurs suivantes :
      • us pour l'emplacement multirégional US
      • eu pour l'emplacement multirégional EU
      • global pour l'emplacement mondial
      Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
    • LOCATION : emplacement multirégional de votre data store : global, us ou eu.

    La réponse contient la liste des datastores :

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

    Dans cet exemple, les ID du data store d'entités sont DataConnector3_entityA et DataConnector3_entityB. Utilisez ces ID lorsque vous configurez des contrôles d'accès pour tous les datastores d'entités sous-jacents d'un data store multientité à l'aide de l'API REST.

Étapes suivantes