Connettiti a Cloud SQL

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

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

  • Query federata (consigliata) [Anteprima]: connettiti ai dati di Cloud SQL in loco senza incorrere in costi di traffico in uscita per la copia e lo spostamento dei dati. La query federata invia la query direttamente a Cloud SQL su tutte le istanze, i database e le tabelle a cui la tua identità ha l'autorizzazione 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.

  • Acquisizione dei dati: copia i dati da una tabella Cloud SQL specifica nel datastore Gemini Enterprise. I dati devono essere aggiornati manualmente per riflettere le modifiche nella tabella Cloud SQL. 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 Cloud SQL 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 l'applicazione delle policy dell'organizzazione è abilitata, assicurati che la policy dell'organizzazione consenta al connettore di:

Inoltre, completa i prerequisiti e configura le autorizzazioni IAM di Cloud SQL richieste per la modalità connettore che intendi utilizzare:

Query federata

Per connetterti a Cloud SQL utilizzando la modalità di query federata, completa i seguenti prerequisiti nel Google Cloud progetto che contiene l'istanza Cloud SQL:

  1. Abilita l'API Data sull'istanza Cloud SQL:

    gcloud sql instances patch <var>INSTANCE_NAME</var> \
    --project=<var>PROJECT_ID</var> \
    --data-api-access=ALLOW_DATA_API

  2. Concedi le autorizzazioni IAM: concedi i seguenti ruoli IAM nel Google Cloud progetto che contiene l'istanza Cloud SQL agli utenti che eseguono query o azioni tramite il connettore:

Acquisizione dei dati

Per importare i dati da Cloud SQL, configura le seguenti autorizzazioni IAM:

  • Accesso al bucket di gestione temporanea: quando importi i dati da Cloud SQL, i dati vengono prima trasferiti in un bucket Cloud Storage. Concedi il ruolo Amministratore Storage (roles/storage.admin) sul bucket Cloud Storage intermedio al service account dell'istanza Cloud SQL (ad esempio, p9876-abcd33f@gcp-sa-cloud-sql.).
  • Accesso a Cloud SQL tra progetti: se importi 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 Visualizzatore Cloud SQL (roles/cloudsql.viewer) nel progetto Cloud SQL di origine al service-PROJECT_NUMBER@gcp-sa-discoveryengine. account di servizio (dove PROJECT_NUMBER è il numero del Google Cloud progetto che contiene il datastore Gemini Enterprise).

Creare un datastore Cloud SQL

Per creare un datastore che connette i dati di Cloud SQL 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 "Cloud SQL" nel campo di ricerca Seleziona un'origine dati o trova Cloud SQL nell'elenco delle origini dati di prime parti. 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à scelta.

    Query federata

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

    Acquisizione dei dati

    1. Seleziona Importazione dati.
    2. Specifica i dettagli dei dati che vuoi importare. In Importa i dati dalla tabella Cloud SQL, specifica le seguenti informazioni:
      • ID progetto: il Google Cloud progetto che contiene la tabella Cloud SQL. Questo è un campo obbligatorio.
      • ID istanza: l'ID istanza Cloud SQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • ID database: l'ID database Cloud SQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • ID tabella: l'ID tabella Cloud SQL che contiene i dati che vuoi importare. Questo è un campo obbligatorio.
      • Inserisci la località del bucket Google Cloud Storage per i dati. Questo campo è obbligatorio. Facoltativamente, seleziona Abilita l'esportazione serverless per utilizzare l'esportazione serverless di Cloud SQL. L'abilitazione dell'esportazione serverless comporta costi aggiuntivi. Consulta i prezzi dell'esportazione serverless di Cloud SQL.
    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. 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 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 Cloud SQL quando gli utenti eseguono query tramite l'app collegata; in modalità di importazione dati, l'importazione dei dati comporta costi di indicizzazione di Cloud SQL, Cloud Storage 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