Ottieni i dettagli del datastore e dell'entità

Questa pagina spiega come recuperare i dettagli delle risorse per i datastore 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 configurando i controlli dell'accesso IAM a livello di risorsa, eseguendo query sugli endpoint di ricerca o automatizzando 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 contenitore per i dati importati 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 Google Cloud e di una località (projects/{project}/locations/{location}/collections/{collection}).

I datastore di terze parti multientità (come Jira, Salesforce o SharePoint Online) creano una raccolta dedicata che rappresenta l'istanza del datastore.
Entità datastore Quando connetti 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 delle entità si trovano come risorse secondarie in collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID}.

Per maggiori informazioni, consulta le pagine Dati strutturati per datastore di terze parti e Introduzione a connettori e datastore.

Recuperare 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 > Data Stores.

    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 entità (ad esempio DataConnector3_entityA e DataConnector3_entityB).

REST

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

  1. Elenca gli ID raccolta datastore (per i datastore multientità):

    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 dell'elenco 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 Google Cloud progetto.
    • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multiregione EU
      • global per la località Globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la multiregione 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 di accesso 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 multientità ha un ID raccolta dedicato (ad esempio DataConnector3), i relativi datastore entità secondarie sono registrati in default_collection e hanno come prefisso l'ID del connettore.

    Chiama l'endpoint dell'elenco dataStores su default_collection per individuare l'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 Google Cloud progetto.
    • ENDPOINT_LOCATION: la multiregione per la tua richiesta API. Specifica uno dei seguenti valori:
      • us per la multi-regione Stati Uniti
      • eu per la multiregione EU
      • global per la località Globale
      Per saperne di più, consulta Specifica una multi-regione per il datastore.
    • LOCATION: la multiregione 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 dei datastore delle entità sono DataConnector3_entityA e DataConnector3_entityB. Utilizza questi ID quando configuri i controlli dell'accesso per tutti i datastore delle entità sottostanti di un datastore multientità utilizzando l'API REST.

Passaggi successivi