Connessione a BigQuery

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

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

• Query federata (consigliata) [Anteprima]: connettiti ai dati BigQuery in loco senza sostenere costi di uscita per la copia e lo spostamento dei dati. La query federata invia la query direttamente a BigQuery in tutti i set di dati e le tabelle per cui la tua identità dispone dell'autorizzazione di accesso di Identity and Access Management (IAM), il che è più efficiente per le query analitiche. Poiché le query vengono eseguite utilizzando le tue credenziali, le autorizzazioni IAM di BigQuery, inclusa la sicurezza a livello di riga, rimangono invariate. Quando utilizzi la modalità di query federata, Knowledge Catalog viene attivato automaticamente nella scheda Assistente della tua 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 BigQuery specifica al datastore Gemini Enterprise. I dati devono essere aggiornati per riflettere le modifiche nella tabella BigQuery. Questa modalità comporta costi di traffico in 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 BigQuery in Gemini Enterprise, devi disporre del ruolo Amministratore Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) o Amministratore Discovery Engine (roles/discoveryengine.admin). Per saperne di più, consulta Concedi le autorizzazioni agli amministratori.

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

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

Inoltre, configura le autorizzazioni IAM di BigQuery richieste per la modalità connettore che prevedi di 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.

La modalità Query federata utilizza il server MCP BigQuery. Poiché i diversi strumenti MCP (azioni) richiedono autorizzazioni diverse, le autorizzazioni IAM necessarie dipendono dagli strumenti che utilizzi. Per saperne di più, consulta Ruoli richiesti nella documentazione di BigQuery MCP.

Nota: gli utenti non devono necessariamente avere il ruolo MCP Tool User (roles/mcp.toolUser), anche se il connettore è configurato per utilizzare azioni che richiedono questo ruolo.

Di seguito sono riportati i ruoli IAM più comunemente applicati agli utenti che eseguono query o azioni tramite il connettore:

• BigQuery Job User (roles/bigquery.jobUser) sul progetto BigQuery Google Cloud in cui viene eseguita la query (progetto di computing o di fatturazione), per consentire agli utenti di eseguire job di query.
• BigQuery Data Viewer (roles/bigquery.dataViewer) sul progetto BigQuery Google Cloud in cui sono archiviati i dati (progetto di archiviazione), per consentire agli utenti di accedere ai dati in una query o tramite strumenti di metadati BigQuery come get_table_info. Se le azioni di scrittura sono abilitate, concedi invece BigQuery Data Editor (roles/bigquery.dataEditor).

Acquisizione dei dati

Per importare dati da un progetto di origine Google Cloud diverso dal progetto Google Cloud che contiene il datastore Gemini Enterprise che stai creando, concedi i seguenti ruoli IAM sul progetto BigQuery di origine al account di servizio [e-mail] (dove PROJECT_NUMBER è il numero di progetto del progettoGoogle Cloud che contiene il datastore Gemini Enterprise):

• BigQuery Job User (roles/bigquery.jobUser)
• BigQuery Data Editor (roles/bigquery.dataEditor)

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

Crea un datastore BigQuery

Per creare un datastore che connette i dati di BigQuery 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 "BigQuery" nel campo di ricerca Seleziona un'origine dati o trova BigQuery nell'elenco delle origini dati proprietarie. Seleziona Aggiungi origine dati.

5. Nella pagina Dati, seleziona la modalità connettoreper connetterti 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).
   2. Facoltativamente, in Opzioni avanzate, specifica il progetto di fatturazione Google Cloud per l'esecuzione delle query del datastore digitando l'ID progetto nel campo ID progetto di fatturazione. Se lasci vuoto questo campo, le query richiederanno all'utente un progetto di fatturazione o si baseranno su istruzioni personalizzate.
   3. Fai clic su Continua.
   4. Nella pagina Azioni, seleziona le azioni BigQuery che vuoi attivare per il tuo datastore. Puoi modificare queste impostazioni in un secondo momento. Fai clic su Continua.

   Acquisizione dei dati

   1. Seleziona Acquisizione dei dati.
   2. Determina il tipo di dati che stai importando. Prima di importare i dati, consulta Prepara i dati per l'importazione.
      • Se stai importando dati strutturati, seleziona Tabella BigQuery con il tuo schema o Tabella BigQuery con metadati. Se utilizzi il tuo schema, questo verrà rilevato automaticamente durante l'importazione. Se utilizzi i metadati, devi definire uno schema specificato da Google durante l'importazione.
      • Se stai importando dati che richiedono un'elaborazione specializzata, seleziona una delle opzioni in Importazione dati specializzata.

   3. In Frequenza di sincronizzazione, seleziona la frequenza con cui vuoi importare i dati dalla tabella BigQuery. Questa opzione non può essere modificata dopo la creazione del datastore.

      • Seleziona Una volta per una singola importazione.
      • Seleziona Periodica per impostare una pianificazione di importazione ricorrente.

   4. Seleziona la tabella di dati da importare. Nel campo Percorso BigQuery, fai clic su Sfoglia, seleziona una tabella che hai preparato per l'importazione e poi fai clic su Seleziona. In alternativa, inserisci la posizione della tabella direttamente nel campo Percorso BigQuery.

   5. Fai clic su Continua.

   Dopo aver creato il datastore, puoi controllare lo stato dell'importazione andando alla pagina Datastore e facendo clic sul nome del datastore per visualizzarne i dettagli nella pagina Data (Dati). Quando la colonna dello stato nella scheda Attività cambia da In corso a Importazione completata, l'importazione è terminata.

   A seconda delle dimensioni dei dati, l'importazione può richiedere diversi minuti o diverse ore.

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 località multiregionali, 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. Facoltativamente, 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: projects/{project}/locations/{location}/contentPolicies/{policy}. Puoi modificare questa impostazione in un secondo momento.

7. Fai clic su Crea.

Ora puoi collegare il tuo datastore a un'app Gemini Enterprise. In modalità query federata, le query comportano costi di calcolo di BigQuery quando gli utenti eseguono query tramite l'app collegata; in modalità importazione dati, l'importazione dei dati comporta costi di indicizzazione di BigQuery e Gemini Enterprise anche prima che il datastore venga collegato a un'app. Per scoprire 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 Crea 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 a cercare il contesto dell'organizzazione.

• Per creare un agente con ambito con query verificate in BigQuery, consulta Pubblica un agente di dati BigQuery in Gemini Enterprise.