Gestire i set di contesto in Spanner Studio

Questo documento descrive come creare set di contesto in Spanner Studio utilizzando un file di set di contesto. Quando crei un set di contesto in Spanner Studio, Spanner Studio 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 Spanner Studio, la creazione di un set di contesto 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 contesto 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 Spanner 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 Spanner Studio.

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

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'istanza Spanner

Ruoli e autorizzazioni richiesti

  • Aggiungi un utente o un account di servizio IAM all'istanza. Per saperne di più, consulta Applica i ruoli IAM.
  • Concedi i ruoli roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer e roles/geminidataanalytics.queryDataUser all'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 per i set di contesti.
  • Concedi ruoli e autorizzazioni all'utente IAM a livello di progetto per i database richiesti.

Crea un set di contesti

Per creare un set di contesti, segui questi passaggi:

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

    Vai a Spanner

  2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

  3. Nel menu di navigazione, fai clic su Spanner Studio.

  4. Nel riquadro Explorer, accanto a Set di contesto, fai clic su Visualizza azioni.

  5. Fai clic su Crea set di contesti.

  6. In Nome set di contesti, fornisci un nome univoco per il set di contesti. In Spanner 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 contesto default del progetto per la regione selezionata. Ad esempio, il nome del set di contesti querydata_e2e_test ha l'ID set di contesti querydata-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.

  7. Facoltativo. In Descrizione set di contesti, aggiungi una descrizione per il set di contesti.

  8. 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.

  9. 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-east1 per ogni creazione). Se scegli una regione diversa da us-east1, selezionala prima di inserire il nome del set di contesto, in modo che Spanner Studio convalidi l'univocità del nome in quella regione.

  10. 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:

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

    Vai a Spanner

  2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

  3. Nel menu di navigazione, fai clic su Spanner Studio.

  4. Fai clic su Visualizza azioni accanto al set di contesti da modificare.

  5. Fai clic su Modifica set di contesti.

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

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

  8. Fai clic su Salva.

Elimina un set di contesti

Per eliminare un set di contesti, segui questi passaggi:

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

    Vai a Spanner

  2. Seleziona un'istanza dall'elenco, quindi seleziona un database.

  3. Nel menu di navigazione, fai clic su Spanner Studio.

  4. Fai clic su Visualizza azioni accanto all'insieme di contesti che vuoi eliminare.

  5. Fai clic su Elimina set di contesti.

  6. Nella finestra di dialogo di conferma Elimina set di contesti, inserisci l'ID del set di contesti.

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

Passaggi successivi