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 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 :
Dans la console Google Cloud , accédez à la page Gemini Enterprise > Datastores.
Cliquez sur le nom de votre data store cible.
Sur la page d'informations du data store, consultez l'ID du datastore affiché dans l'en-tête.
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_entityAetDataConnector3_entityB).
REST
Pour récupérer les ID de data store et d'entité à l'aide de l'API REST, procédez comme suit :
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
collectionspour 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 :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueu.
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.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 queDataConnector3), ses datastores d'entités enfants sont enregistrés sousdefault_collectionet précédés de l'ID du connecteur.Appelez le point de terminaison de la liste
dataStoressurdefault_collectionpour 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 :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
LOCATION: emplacement multirégional de votre data store :global,usoueu.
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_entityAetDataConnector3_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
- Configurer des contrôles d'accès précis pour les applications et les datastores
- Documentation de référence de l'API REST Discovery Engine