Questo documento descrive come creare set di contesti in AlloyDB per PostgreSQL Studio utilizzando un file di set di contesti. Quando crei un set di contesto in AlloyDB Studio, questo lo archivia nel gruppo di set di contesto default del progetto per la regione selezionata e lo collega al database corrente. I nomi dei set di contesto (e i relativi ID dei set di contesto derivati) devono essere univoci all'interno del gruppo di set di contesto default del progetto per una determinata regione, in tutti i database e le istanze. In AlloyDB Studio, la creazione di un set di contesti con un nome il cui ID derivato esiste già non supera la convalida. Per sovrascrivere i contenuti mantenendo le associazioni al database, modifica il set di contesti esistente. Il caricamento diretto tramite l'agente di context engineering o l'API Dataplex con un ID set di contesto esistente sostituisce i contenuti e, se specificate, le associazioni di database.
L'elenco Set di contesto in AlloyDB Studio mostra solo i set di contesto nel gruppo di set di contesto default in tutte le regioni supportate collegate al database corrente. I set di contesto creati per un altro database o tramite l'API senza collegare la risorsa del database in databases (o in un gruppo di set di contesto personalizzato) non vengono visualizzati nell'elenco di AlloyDB Studio.
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 di nuovi.Questo tutorial richiede un database nell'istanza AlloyDB. Per saperne di più, consulta Crea un database.
Ruoli e autorizzazioni richiesti
- Abilita l'autenticazione del database Identity and Access Management (IAM) sull'istanza impostando il flag di database
alloydb.iam_authenticationsuon(alloydb.iam_authentication=on). Per saperne di più, consulta Abilita e disabilita l'autenticazione IAM. - Aggiungi un utente o un account di servizio IAM al cluster a livello di database. Per saperne di più, consulta Gestisci l'autenticazione IAM.
- Concedi i ruoli
alloydb.databaseUser,serviceusage.serviceUsageConsumeregeminidataanalytics.queryDataUserall'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungi l'associazione delle policy IAM per un progetto. - Per creare, caricare e gestire i set di contesto, concedi il ruolo Dataplex Catalog Editor (
roles/dataplex.catalogEditor) o Dataplex Catalog Admin (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",
}'
PROJECT_ID: l'ID del tuo progetto Google Cloud .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.
Crea un set di contesti
Per creare un set di contesti, segui questi passaggi:
Nella console Google Cloud , vai alla pagina AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB Studio.
Accedi ad AlloyDB Studio utilizzando l'autenticazione IAM.
Nel riquadro Explorer, accanto a Set di contesto, fai clic su Visualizza azioni.
Fai clic su Crea set di contesti.
In Nome set di contesti, fornisci un nome univoco per il set di contesti. In AlloyDB Studio, il nome deve avere una lunghezza compresa tra 4 e 30 caratteri e non può iniziare con uno spazio vuoto. Studio ricava l'ID del set di contesto convertendo il nome in minuscolo e sostituendo i caratteri non alfanumerici con trattini (
-). L'ID del set di contesto derivato deve essere univoco all'interno del gruppo di set di contestodefaultdel progetto per la regione selezionata. Ad esempio, il nome del set di contestiquerydata_e2e_testha l'ID set di contestiquerydata-e2e-test. Quando carichi un set di contesto direttamente utilizzando l'agente di context engineering o l'API Dataplex, l'ID del set di contesto è sensibile alle maiuscole, non può contenere barre (/) e non è limitato a un numero di caratteri compreso tra 4 e 30 o a caratteri alfanumerici, trattini e trattini bassi.Facoltativo. In Descrizione set di contesti, aggiungi una descrizione per il set di contesti.
Facoltativo. Per caricare un file del set di contesto, fai clic su Sfoglia nella sezione Carica file del set di contesto e seleziona il file del set di contesto.
Facoltativo. Per scegliere una regione per il set di contesto, fai clic su Mostra opzioni avanzate e seleziona una regione in Seleziona una località (il valore predefinito è
us-east1per ogni creazione). Se scegli una regione diversa daus-east1, selezionala prima di inserire il nome del set di contesto in modo che AlloyDB Studio convalidi l'univocità del nome in quella regione.Fai clic su Crea.
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 del set di contesti. Puoi quindi modificare il set di contesto per caricare il file del set di contesto.
Modifica un set di contesti
Per modificare un set di contesti, segui questi passaggi:
Nella console Google Cloud , vai alla pagina AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB Studio.
Accedi ad AlloyDB Studio utilizzando l'autenticazione IAM.
Fai clic su Visualizza azioni accanto al set di contesti da modificare.
Fai clic su Modifica set di contesti.
Facoltativo. Modifica la descrizione del set di contesti.
Fai clic su Sfoglia nella sezione Carica file del set di contesto e seleziona il file del set di contesto.
Fai clic su Salva.
Elimina un set di contesti
Per eliminare un set di contesti, segui questi passaggi:
Nella console Google Cloud , vai alla pagina AlloyDB.
Seleziona un cluster dall'elenco.
Nel menu di navigazione, fai clic su AlloyDB Studio.
Accedi ad AlloyDB Studio utilizzando l'autenticazione IAM.
Fai clic su Visualizza azioni accanto all'insieme di contesti che vuoi eliminare.
Fai clic su Elimina set di contesti.
Nella finestra di dialogo di conferma Elimina set di contesti, inserisci l'ID del set di contesti.
Fai clic su Conferma per eliminare il set di contesti.
Passaggi successivi
- Scopri di più sui set di contesti.
- Scopri come testare un set di contesti.
- Scopri come creare contesti utilizzando Gemini CLI.