Gestire i set di contesto in AlloyDB Studio

Questo documento descrive come creare set di contesti in AlloyDB per PostgreSQL Studio utilizzando un file di set di contesti. I nomi dei set di contesto 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.

Attiva i servizi richiesti

Abilita i seguenti servizi per il tuo progetto:

Prepara un cluster, un'istanza e un database AlloyDB per PostgreSQL

Assicurati di avere accesso a un cluster e a un'istanza AlloyDB esistenti o creane uno nuovo.
Questo tutorial richiede un database nell'istanza AlloyDB. Per saperne di più, consulta Creare un database.

Ruoli e autorizzazioni richiesti

  • Aggiungi un utente o un account di servizio Identity and Access Management (IAM) al cluster a livello di database. Per saperne di più, vedi Gestire gli utenti del database.
  • Concedi all'utente IAM i ruoli alloydb.databaseUser, serviceusage.serviceUsageConsumer e geminidataanalytics.queryDataUser a livello di progetto. Per saperne di più, consulta Aggiungere l'associazione di policy IAM per un progetto.
  • Per creare, caricare e gestire i set di contesto, concedi il ruolo Editor del catalogo Dataplex (roles/dataplex.catalogEditor) o Amministratore del catalogo Dataplex (roles/dataplex.catalogAdmin) all'utente IAM a livello di progetto. Per saperne di più, consulta Autorizzazioni dei set di contesto.

Concedi l'autorizzazione executesql all'istanza AlloyDB per PostgreSQL

Per concedere l'autorizzazione executesql all'istanza AlloyDB per PostgreSQL e impostare l'impostazione dell'istanza data_api_access sul valore ALLOW_DATA_API, utilizza il seguente comando curl: 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
Sostituisci quanto segue:
  • PROJECT_ID: l'ID del tuo Google Cloud progetto.
  • LOCATION: la regione in cui si trova il cluster AlloyDB.
  • CLUSTER_ID: l'ID del tuo cluster AlloyDB.
  • INSTANCE_ID: l'ID dell'istanza AlloyDB.
Per eseguire i passaggi di questo tutorial, accedi a Google Cloud, quindi autenticati al database utilizzando l'autenticazione IAM.

Creare un set di contesti

Per creare un insieme di contesti, segui questi passaggi:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB 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 insieme di contesti.

  7. In Nome set di contesti, fornisci un nome univoco per il set di contesti. Il nome del set di contesto è sensibile alle maiuscole 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.

Creare set di contesti

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

Modificare un set di contesti

Per modificare un insieme di contesti:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB 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 Modifica insieme di contesti.

  7. Facoltativo. Modifica la descrizione del set di contesti.

  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 set di contesti

Per eliminare un insieme di contesti, segui questi passaggi:

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

    Vai ad AlloyDB

  2. Seleziona un cluster dall'elenco.

  3. Nel menu di navigazione, fai clic su AlloyDB 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 Elimina set di contesti.

  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.

Passaggi successivi