Connettiti a Spanner

Questo documento descrive come creare un datastore che si connette ai dati Spanner. Puoi collegare questo datastore a un'app Gemini Enterprise per consentire agli agenti di analizzare i tuoi dati.

Per connetterti ai dati Spanner utilizzando un datastore Gemini Enterprise, puoi utilizzare una delle seguenti modalità:

  • Query federata (consigliata) [Anteprima]: Connettiti ai dati Spanner sul posto senza sostenere costi di uscita per la copia e lo spostamento dei dati. La query federata invia la query direttamente a Spanner in tutti i database e le tabelle a cui la tua identità dispone dell'autorizzazione IAM (Identity and Access Management) per accedere, il che è più efficiente per le query analitiche. Quando utilizzi la modalità di query federata, Knowledge Catalog viene attivato automaticamente nella scheda Assistente dell'app Gemini Enterprise per fornire all'agente gli strumenti per cercare i dati a cui l'utente ha accesso e cercare il contesto.

  • Acquisizione dei dati: copia i dati da una tabella Spanner specifica nel datastore Gemini Enterprise. I dati devono essere aggiornati manualmente per riflettere le modifiche apportate alla tabella Spanner. Questa modalità comporta costi di uscita per il trasferimento dei dati in una nuova posizione e le autorizzazioni IAM esistenti non vengono replicate nell'archivio dati.

Prima di iniziare

Per creare un datastore Spanner in Gemini Enterprise, devi disporre del ruolo Amministratore Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o Amministratore Discovery Engine (roles/discoveryengine.admin). Per saperne di più, vedi Concedere autorizzazioni agli amministratori.

Se il tuo progetto è protetto da un perimetro Controlli di servizio VPC o se l'applicazione delle norme dell'organizzazione è abilitata, assicurati che le norme dell'organizzazione consentano il connettore:

Inoltre, configura le autorizzazioni IAM Spanner richieste per la modalità connettore che prevedi di utilizzare:

Query federata

Per connetterti a Spanner utilizzando la modalità query federata, concedi i seguenti ruoli IAM agli utenti che eseguono query o azioni tramite il connettore nel progettoGoogle Cloud che contiene il tuo database Spanner:

Acquisizione dei dati

Per importare dati da un progetto Google Cloud di origine diverso dal progetto Google Cloud che contiene il datastore Gemini Enterprise che stai creando, concedi uno dei seguenti ruoli IAM nel progetto Spanner di origine al account di servizio service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com (dove PROJECT_NUMBER è il numero di progetto del progettoGoogle Cloud che contiene il datastore Gemini Enterprise):

Crea un datastore Spanner

Per creare un datastore che connette i dati di Spanner a Gemini Enterprise, segui questi passaggi:

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

    Gemini Enterprise

  2. Vai alla pagina Datastore.

  3. Fai clic su Crea datastore.

  4. Nella pagina Origine, scegli un'origine dati per il datastore. Cerca "Spanner" nel campo di ricerca Seleziona un'origine dati oppure trova Spanner nell'elenco delle origini dati proprietarie. Seleziona Aggiungi origine dati.

  5. Nella pagina Dati, seleziona la modalità connettore per la connessione ai dati. Seleziona una delle seguenti schede per ulteriori istruzioni in base alla modalità che hai scelto.

    Query federata

    1. Seleziona Query federata (consigliata). Fai clic su Continua.
    2. Nella pagina Azioni, seleziona le azioni Spanner che vuoi attivare per il datastore. Puoi modificare queste impostazioni in un secondo momento. Fai clic su Continua.

    Acquisizione dei dati

    1. Seleziona Acquisizione dei dati.

    2. Specifica i dettagli sui dati che vuoi importare. In Importa i dati dalla tua tabella Spanner, specifica le seguenti informazioni:

      • ID progetto: il Google Cloud progetto che contiene la tabella Spanner. Questo campo è obbligatorio.
      • ID istanza: l'ID istanza Spanner che contiene i dati da importare. Questo campo è obbligatorio.
      • ID database: l'ID database Spanner che contiene i dati da importare. Questo campo è obbligatorio.
      • ID tabella: l'ID tabella Spanner che contiene i dati da importare. Questo campo è obbligatorio.

      (Facoltativo) Seleziona Attiva Data Boost per utilizzare Spanner Data Boost per query più veloci. L'attivazione di Data Boost comporta costi aggiuntivi. Consulta Fatturazione e quote di Spanner Data Boost.

    3. Fai clic su Continua.

  6. Nella pagina Configurazione, configura le impostazioni del datastore.

    • Posizione del connettore dati: scegli una regione in cui archiviare i metadati del datastore. Non puoi modificare la posizione dopo la creazione del datastore. Per informazioni importanti sulle multiregioni, consulta Località di Gemini Enterprise.
    • Nome connettore dati: nel campo Nome connettore dati, inserisci un nome per il connettore dati. Non puoi modificare il nome dopo la creazione del connettore dati. L'inserimento di un nome genera un ID univoco per il connettore dati. (Facoltativo) Nel campo Tag (facoltativo), inserisci un tag per il connettore dati, che funge da identificatore stabile per il connettore in tutte le versioni.
    • Policy di protezione dei dati sensibili: seleziona una policy di protezione dei dati sensibili per il datastore. Il formato deve essere il seguente: projects/{project}/locations/{location}/contentPolicies/{policy}. Puoi modificare questa impostazione in un secondo momento.

  7. Fai clic su Crea.

Ora puoi collegare il datastore a un'app Gemini Enterprise. In modalità di query federata, le query comportano costi di utilizzo di Spanner quando gli utenti eseguono query tramite l'app collegata; in modalità di importazione dati, l'importazione dei dati comporta costi di indicizzazione di Spanner e Gemini Enterprise anche prima che il datastore venga collegato a un'app. Per saperne di più su questi addebiti, consulta Prezzi di Gemini Enterprise.

Passaggi successivi