Gestire i set di contesto in Cloud SQL per MySQL 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 contesti in Cloud SQL per MySQL Studio utilizzando un file di set di contesti. I nomi dei set di contesti devono essere univoci all'interno di un database.

Per scoprire di più sui set di contesti, consulta la panoramica dei set di contesti.

Prima di iniziare

Completa i seguenti prerequisiti prima di creare un agente.

Abilita i servizi richiesti

Abilita i seguenti servizi per il tuo progetto:

• API Data Analytics con Gemini
• API Gemini for Google Cloud
• API Knowledge 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 Crea istanze per Cloud SQL.
• Assicurati di creare un database nell'istanza in cui creerai le tabelle. Per saperne di più, consulta Crea un database sull' istanza Cloud SQL.

Ruoli e autorizzazioni richiesti

• Aggiungi un utente IAM o un account di servizio a livello di istanza. Per saperne di più, consulta Aggiungi un binding dei criteri IAM a un utente, un account di servizio o un gruppo.
• Concedi i ruoli cloudsql.studioUser, cloudsql.instanceUser e geminidataanalytics.queryDataUser all'utente IAM o al account di servizio a livello di progetto. Per saperne di più, consulta Aggiungi un binding dei criteri IAM per un progetto.
• Devi avere un utente con privilegi che conceda i privilegi del database a l'utente IAM o al service account.
  
  GRANT SELECT PRIVILEGES ON * TO "IAM_USERNAME";.
  
  Per saperne di più, consulta Concedi i privilegi del database a un singolo utente IAM o service account.

Concedi l'autorizzazione executesql all'istanza Cloud SQL

Per concedere l'autorizzazione executesql all'istanza Cloud SQL e abilitare l'API dati Cloud SQL, esegui il seguente 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 descritti in questo tutorial, accedi a Google Cloude poi autenticati al database utilizzando l'autenticazione IAM.

Crea un set di contesti

Per creare un set di contesti:

1. Nella Google Cloud console, 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 del set di contesti, fornisci un nome univoco per il set di contesti. Il nome del set di contesti fa distinzione tra maiuscole e minuscole e può contenere lettere, numeri, trattini e trattini bassi.

8. (Facoltativo) In Descrizione del set di contesti, aggiungi una descrizione per il set di contesti.

9. Fai clic su Crea.

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

Crea set di contesti

Dopo aver creato un set di contesti, segui i passaggi descritti in Crea contesti utilizzando Gemini CLI per creare un file di set di contesti. Puoi quindi modificare il set di contesti per caricare il file del set di contesti.

Modifica un set di contesti

Per modificare un set di contesti:

1. Nella Google Cloud console, 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 set di contesti.

7. (Facoltativo) Modifica la Descrizione del set di contesti.

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

9. Fai clic su Salva.

Elimina un set di contesti

Per eliminare un set di contesti:

1. Nella Google Cloud console, 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 contesti.

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

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

Nota: prima di eliminare un database, devi eliminare tutti i set di contesti associati a quel database.

Passaggi successivi

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