Ottieni i dettagli del datastore e dell'entità

Questa pagina spiega come recuperare i dettagli delle risorse per i datastore di Gemini Enterprise e le relative entità sottostanti utilizzando la console Google Cloud o l'API REST Discovery Engine.

Quando interagisci con i datastore utilizzando le API, ad esempio per configurare i controlli dell'accesso IAM a livello di risorsa, eseguire query sugli endpoint di ricerca o automatizzare le pipeline di importazione, hai bisogno degli ID risorsa univoci dei datastore di destinazione e delle relative entità sottostanti.

Concetti relativi ai datastore

Per capire come sono strutturate le risorse del datastore nell'API Discovery Engine, considera i seguenti concetti:

Concetto Descrizione
Data store Un container per i dati acquisiti da Google o da origini dati di terze parti. I datastore autonomi appartengono alla raccolta predefinita (default_collection). Per saperne di più, consulta Concetti di Gemini Enterprise e Informazioni su app e datastore.
Raccolta dei dati Una risorsa di raggruppamento logico all'interno di un progetto e di una località Google Cloud (projects/{project}/locations/{location}/collections/{collection}).

I datastore di terze parti con più entità (come Jira, Salesforce o SharePoint Online) creano una raccolta dedicata che rappresenta l'istanza del datastore.

Entità del datastore Quando colleghi un'origine dati di terze parti che contiene più tipi di entità (ad esempio problemi Jira, progetti Jira o file SharePoint), Gemini Enterprise crea automaticamente un datastore secondario separato per ogni tipo di entità.

Questi datastore di entità si trovano come risorse secondarie in collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Per ulteriori informazioni, consulta Dati strutturati per datastore di terze parti e Introduzione ai connettori e ai datastore.

Recupera i dettagli del datastore e dell'entità

Seleziona una delle seguenti opzioni:

Console

Per recuperare i dettagli del datastore e dell'entità nella console Google Cloud , segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina Gemini Enterprise > Datastore.

    Vai alla pagina Datastore

  2. Fai clic sul nome del datastore di destinazione.

  3. Nella pagina dei dettagli del datastore, visualizza l'ID datastore visualizzato nell'intestazione.

  4. Se il datastore contiene entità, fai clic sulla scheda Entità per visualizzare l'elenco delle entità configurate, i nomi visualizzati e i relativi ID datastore delle entità (ad esempio DataConnector3_entityA e DataConnector3_entityB).

REST

Per recuperare gli ID datastore ed entità utilizzando l'API REST, completa i seguenti passaggi:

  1. Elenca gli ID raccolta del datastore (per i datastore con più entità):

    Per i datastore di terze parti con più entità (come Jira o Salesforce), Gemini Enterprise crea una raccolta dedicata che rappresenta l'istanza del connettore. Chiama l'endpoint list collections per recuperare gli ID raccolta nel tuo progetto:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
    • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multi-regione UE
      • global per la località globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la località multiregionale del datastore: global, us o eu.

    La risposta contiene l'elenco delle raccolte:

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

    In questo esempio, l'ID raccolta è DataConnector3. Utilizza questo ID quando configuri i controlli degli accessi a livello di raccolta per l'istanza del connettore.

  2. Elenca gli ID entità e datastore autonomi in default_collection:

    In Gemini Enterprise, tutte le risorse del datastore, inclusi i datastore autonomi e le entità secondarie per i connettori multientità, si trovano in default_collection. Anche se un datastore multi-entità ha un ID raccolta dedicato (ad esempio DataConnector3), i datastore delle entità secondarie sono registrati in default_collection e hanno come prefisso l'ID connettore.

    Chiama l'endpoint di elenco dataStores su default_collection per individuare gli ID del datastore e dell'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"
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progettoGoogle Cloud .
    • ENDPOINT_LOCATION: la località multiregionale per la richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multi-regione UE
      • global per la località globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la località multiregionale del datastore: global, us o eu.

    La risposta contiene l'elenco dei datastore:

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

    In questo esempio, gli ID datastore delle entità sono DataConnector3_entityA e DataConnector3_entityB. Utilizza questi ID quando configuri i controlli di accesso per tutti i datastore di entità sottostanti di un datastore multientità utilizzando l'API REST.

Passaggi successivi