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

Cette page explique comment récupérer les détails des ressources des datastores Gemini Enterprise et de 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 ressource uniques des datastores cibles et de leurs entités sous-jacentes.

Concepts de datastore

Pour comprendre comment les ressources de data store sont structurées 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 de Gemini Enterprise et À propos des applications et des datastores.
Collecte des 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 (comme Jira, Salesforce ou SharePoint Online) créent une collection dédiée représentant l'instance de data store.

Entité de datastore Lorsque vous connectez une source de données tierce contenant plusieurs types d'entités (par exemple, 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 datastores 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 datastores tiers et Présentation des connecteurs et des datastores.

Récupérer les détails d'un data store et d'une 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épertorier les ID de collection 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 de liste collections 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 : emplacement multirégional de 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 collection est DataConnector3. Utilisez cet ID lorsque vous configurez des contrôles des accès au niveau de la collection pour l'instance de connecteur.

  2. Répertoriez les ID d'entité et de data store autonome 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é 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 votre data store et vos ID 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 : emplacement multirégional de 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 des data store d'entités sont DataConnector3_entityA et DataConnector3_entityB. Utilisez ces ID lorsque vous configurez les contrôles d'accès pour tous les datastores d'entités sous-jacents d'un data store multi-entité à l'aide de l'API REST.

Étapes suivantes