Gestire i set di contesto in Cloud SQL per PostgreSQL Studio

MySQL   |  PostgreSQL   |  SQL Server

Anteprima

Queste funzionalità sono ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici e ai Termini aggiuntivi per i prodotti in anteprima dell'AI generativa. 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 informazioni sull'accesso a questa release, consulta la pagina di richiesta di accesso.

Questo documento descrive come creare set di contesto in Cloud SQL per PostgreSQL Studio utilizzando un file di set di contesto. I nomi dei set di contesto devono essere univoci all'interno di un database.

Per scoprire di più sui set di contesti, vedi Panoramica dei set di contesti.

Prima di iniziare

Completa i seguenti prerequisiti prima di creare un agente.

Attivare i servizi richiesti

Attiva i seguenti servizi per il tuo progetto:

• API Data Analytics con Gemini
• API Gemini for Google Cloud
• API Dataplex Universal Catalog

Prepara un'istanza Cloud SQL

Assicurati di avere accesso a un'istanza Cloud SQL esistente o creane una nuova. Per saperne di più, consulta Creare istanze per Cloud SQL.

Questo tutorial richiede un database nell'istanza Cloud SQL. Per ulteriori informazioni, vedi Creare un database sull'istanza Cloud SQL.

Ruoli e autorizzazioni richiesti

• Aggiungi un utente IAM o account di servizio all'istanza. Per maggiori informazioni, consulta Gestire gli utenti con l'autenticazione IAM dei database per Cloud SQL.
• Concedi i ruoli cloudsql.studioUser, cloudsql.instanceUser e geminidataanalytics.queryDataUser all'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungere un'associazione di policy IAM per un progetto.
• Devi anche concedere privilegi di database di sola lettura a un utente IAM o account di servizio accedendo come utente con privilegi di superuser, ad esempio l'utente postgres.
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  Sostituisci USER_NAME con l'indirizzo email dell'utente. Devi utilizzare le virgolette intorno all'email perché contiene caratteri speciali (@ e .).
  
  Per saperne di più, consulta Concedere privilegi di database a un service account o a un utente IAM individuale.

Concedi l'autorizzazione executesql all'istanza Cloud SQL

Per concedere l'autorizzazione executesql all'istanza Cloud SQL e abilitare l'API Cloud SQL Data, esegui questo comando:

gcloud config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo Google Cloud progetto.
• INSTANCE_ID: l'ID dell'istanza Cloud SQL.

Per eseguire i passaggi di questo tutorial, accedi a Google Cloud, quindi autenticati al database utilizzando l'autenticazione IAM.

Creare un insieme di contesti

Per creare un insieme di contesti:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione IAM.

5. Nel riquadro Explorer, accanto a Set di contesti, fai clic su Visualizza azioni.

6. Fai clic su Crea set di contesti.

7. In Nome set di contesti, fornisci un nome univoco per il set di contesti. Il nome del set di contesto fa distinzione tra maiuscole e minuscole e può contenere lettere, numeri, trattini e trattini bassi.

8. Facoltativo. In Descrizione del set di contesto, aggiungi una descrizione per il set di contesto.

9. Fai clic su Crea.

Nota: la creazione del primo insieme di contesti in un progetto può richiedere diversi minuti.

Creare insiemi di contesti di build

Dopo aver creato un insieme di contesti, segui i passaggi descritti in Creare contesti utilizzando Gemini CLI per creare un file di insieme di contesti. A questo punto puoi modificare il set di contesto per caricare il file.

Modificare un insieme di contesti

Per modificare un insieme di contesti:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione Identity and Access Management.

5. Nel riquadro Explorer, accanto a Set di contesti, fai clic su Visualizza azioni.

6. Fai clic su Modifica insieme di contesti.

7. (Facoltativo) Modifica la descrizione del set di contesto.

8. Fai clic su Sfoglia nella sezione Carica file del set di contesto e seleziona il file del set di contesto.

9. Fai clic su Salva.

Eliminare un insieme di contesti

Per eliminare un insieme di contesti:

1. Nella console Google Cloud , vai alla pagina Cloud SQL.

   Vai a Cloud SQL

2. Seleziona un'istanza dall'elenco.

3. Nel menu di navigazione, fai clic su Cloud SQL Studio.

4. Accedi a Studio utilizzando l'autenticazione Identity and Access Management.

5. Nel riquadro Explorer, accanto a Set di contesti, fai clic su Visualizza azioni.

6. Fai clic su Elimina set di contesto.

7. Nella finestra di dialogo di conferma Elimina set di contesto, inserisci il nome del set di contesto.

8. Fai clic su Conferma per eliminare il set di contesto.

Nota: prima di eliminare un database, devi eliminare tutti i set di contesto associati.

Passaggi successivi

• Scopri di più sui set di contesto.
• Scopri come testare un insieme di contesti.
• Scopri come creare contesti utilizzando Gemini CLI.