Connettiti ad AlloyDB per PostgreSQL

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

Per connetterti ai dati di AlloyDB per PostgreSQL utilizzando un datastore Gemini Enterprise, puoi utilizzare una delle seguenti modalità:

• Query federata (consigliata) [Anteprima]: connettiti ai dati di AlloyDB per PostgreSQL senza incorrere in costi di uscita per la copia e lo spostamento dei dati. La query federata invia la query direttamente ad AlloyDB per PostgreSQL su tutti i cluster, i database e le tabelle a cui la tua identità ha l'autorizzazione di Identity and Access Management (IAM) per accedere, il che è più efficiente per le query analitiche. Quando utilizzi la modalità di query federata, Knowledge Catalog viene abilitato 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.

  Attenzione: Query di database ad alta precisione: la modalità di query federata fornisce un accesso ampio a tutti i cluster e i database accessibili dall'utente, ma l'accuratezza delle query può variare negli schemi transazionali complessi. Per i carichi di lavoro che richiedono un'elevata accuratezza, l'ambito deterministico delle tabelle e le query verificate (SQL golden), crea un agente dati con ambito in AlloyDB per PostgreSQL e pubblicalo in Gemini Enterprise.

• Importazione dati: copia i dati da una tabella AlloyDB per PostgreSQL specifica nel datastore Gemini Enterprise. I dati devono essere aggiornati manualmente per riflettere le modifiche nella tabella AlloyDB per PostgreSQL. Questa modalità comporta costi di uscita per lo spostamento dei dati in una nuova località e le autorizzazioni IAM esistenti non vengono replicate nel datastore.

Prima di iniziare

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

Se il tuo progetto è protetto da un perimetro di Controlli di servizio VPC o se è abilitata l'applicazione delle policy dell'organizzazione, assicurati che la policy dell'organizzazione consenta al connettore di:

• Aggiungere alloydb al parametro allowedDataSources nel vincolo gestito discoveryengine.managed.allowedDataSources (Limitare le origini dati consentite per i connettori dati). Per saperne di più, consulta Panoramica dei vincoli delle policy gestite e Configurare le origini dati consentite.

Inoltre, configura le autorizzazioni IAM di AlloyDB per PostgreSQL richieste per la modalità di connettore che intendi utilizzare:

Query federata

Anteprima

Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per connetterti ad AlloyDB per PostgreSQL utilizzando la modalità di query federata, concedi i seguenti ruoli IAM nel Google Cloud progetto che contiene il cluster AlloyDB per PostgreSQL agli utenti che eseguono query o azioni tramite il connettore:

• Accesso a cluster e database:
  • Visualizzatore Cloud AlloyDB (roles/alloydb.viewer) e Client Cloud AlloyDB (roles/alloydb.client) (o Utente database Cloud AlloyDB (roles/alloydb.databaseUser) con autenticazione del database IAM) per query e strumenti di sola lettura.
  • Amministratore Cloud AlloyDB (roles/alloydb.admin) se sono abilitate le azioni di scrittura o di gestione dei cluster (ad esempio la creazione di cluster, istanze o backup o l'esecuzione di scritture SQL).
• Accesso allo strumento MCP:
  • Autorizzazione Utente strumento MCP (roles/mcp.toolUser) nel Google Cloud progetto in cui si trova il cluster AlloyDB per PostgreSQL per richiamare gli strumenti MCP.

Importazione dati

Per importare i dati da un Google Cloud progetto di origine diverso dal Google Cloud progetto che contiene il datastore Gemini Enterprise che stai creando, concedi il ruolo Amministratore Cloud AlloyDB (roles/alloydb.admin) nel progetto AlloyDB per PostgreSQL di origine al [e-mail] account di servizio (dove PROJECT_NUMBER è il numero delGoogle Cloud progetto che contiene il datastore Gemini Enterprise).

Attenzione: se scegli di importare i dati da AlloyDB per PostgreSQL in un datastore Gemini Enterprise, le autorizzazioni di AlloyDB per PostgreSQL non vengono importate con i dati. Dopo l'importazione, qualsiasi utente con autorizzazioni Gemini Enterprise sufficienti può visualizzare i dati, anche se non ha l'autorizzazione per visualizzare i dati in AlloyDB per PostgreSQL.

Creare un datastore AlloyDB per PostgreSQL

Per creare un datastore che connette i dati di AlloyDB per PostgreSQL a Gemini Enterprise:

1. Nella Google Cloud console, 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 "AlloyDB per PostgreSQL" nel campo di ricerca Seleziona un'origine dati o trova AlloyDB per PostgreSQL nell'elenco delle Origini dati di prime parti. Seleziona Aggiungi origine dati.

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

   Query federata

   Anteprima

   Questo prodotto o funzionalità sono soggetti ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

   Importazione dati

   1. Seleziona Importazione dati.
   2. Specifica i dettagli dei dati che vuoi importare. In Importa dati dalla tabella AlloyDB per PostgreSQL, specifica le seguenti informazioni:
      • ID progetto: il Google Cloud progetto che contiene la tabella AlloyDB per PostgreSQL. Questo è un campo obbligatorio.
      • ID località: l'ID località AlloyDB per PostgreSQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • ID cluster: l'ID cluster AlloyDB per PostgreSQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • ID database: l'ID database AlloyDB per PostgreSQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • ID tabella: l'ID tabella AlloyDB per PostgreSQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
   3. Fai clic su Continua.

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

   • Località del connettore dati: scegli una regione in cui archiviare i metadati del datastore. Non puoi modificare la località dopo la creazione del datastore. Per informazioni importanti sulle multi-regioni, 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 AlloyDB per PostgreSQL quando gli utenti eseguono query tramite l'app collegata; in modalità di importazione dati, l'importazione dei dati comporta costi di indicizzazione di AlloyDB per PostgreSQL e Gemini Enterprise anche prima che il datastore venga collegato a un'app. Per saperne di più su questi addebiti, consulta i prezzi di Gemini Enterprise.

Passaggi successivi

• Per collegare il datastore a un'app, crea un'app e seleziona il datastore seguendo i passaggi descritti in Creare un'app Gemini Enterprise.

• Scopri come Knowledge Catalog funziona con i connettori di Data Cloud (abilitati automaticamente quando utilizzi la modalità di query federata) per aiutare l'agente a cercare i dati a cui l'utente ha accesso e cercare il contesto organizzativo.

• Per creare un agente con ambito ad alta precisione con query verificate, consulta Pubblicare un agente dati AlloyDB per PostgreSQL in Gemini Enterprise.