Questo documento descrive come creare un agente dati in Cloud SQL per MySQL Studio utilizzando un file di contesto dell'agente. Un agente dati è associato a un singolo file di contesto dell'agente.
Per scoprire di più sugli agenti dati, consulta Panoramica degli agenti dati.Prima di iniziare
Completa i seguenti prerequisiti prima di creare un agente.
Attivare i servizi richiesti
Attiva i seguenti servizi per il tuo progetto: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 Creare un database sull'istanza Cloud SQL.
Ruoli e autorizzazioni richiesti
- Aggiungi un utente IAM o un service account a livello di istanza. Per saperne di più, vedi Aggiungere un binding di policy IAM a un utente, un service account o un gruppo.
- Concedi i ruoli
cloudsql.studioUserecloudsql.instanceUserall'utente IAM a livello di progetto. Per saperne di più, consulta Aggiungere l'associazione di policy IAM per un progetto. - Devi inoltre concedere i privilegi del database a un utente IAM o a un service account accedendo come utente basato su password del database.
GRANT ALL PRIVILEGES ON * TO "IAM_USERNAME";.
Per maggiori informazioni, consulta Concedere privilegi di 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 Cloud SQL
Data, esegui questo comando:
gcloud components update gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID con l'ID dell'istanza Cloud SQL.
Per eseguire i passaggi di questo tutorial, accedi a Cloud de Confiance by S3NS, quindi autenticati al database utilizzando l'autenticazione IAM.
Crea un agente dati
Per creare un agente dati, svolgi i seguenti passaggi:
Nella console Cloud de Confiance by S3NS , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Crea agente.
In Nome agente, fornisci un nome univoco per l'agente. Il nome dell'agente fa distinzione tra maiuscole e minuscole e può contenere lettere, numeri, trattini e trattini bassi.
Facoltativo. In Descrizione agente, aggiungi una descrizione dell'agente.
Facoltativo. Fai clic su Mostra opzioni avanzate e in Seleziona una località, seleziona una regione per archiviare il contesto dell'agente. Puoi scegliere dall'elenco seguente di regioni supportate:
us-central1us-east1europe-west4asia-southeast1
Fai clic su Crea.
Crea il contesto dell'agente
Dopo aver creato un agente, segui i passaggi descritti in Creare contesti utilizzando Gemini CLI per creare un file di contesto dell'agente. A questo punto puoi modificare l'agente per caricare il file di contesto.
Modificare un agente
Per modificare un agente dati:
Nella console Cloud de Confiance , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Modifica agente.
(Facoltativo) Modifica la descrizione dell'agente.
Fai clic su Sfoglia nella sezione Carica file di contesto dell'agente e seleziona il file di contesto dell'agente.
Fai clic su Salva.
Eliminare un agente di dati
Per eliminare un agente dati:
Nella console Cloud de Confiance , vai alla pagina Cloud SQL.
Seleziona un'istanza dall'elenco.
Nel menu di navigazione, fai clic su Cloud SQL Studio.
Accedi a Studio utilizzando l'autenticazione Identity and Access Management (IAM).
Nel riquadro Explorer, accanto a Data Agents, fai clic su Visualizza azioni.
Fai clic su Elimina agente.
Nella finestra di dialogo di conferma Elimina agente, inserisci il nome dell'agente.
Fai clic su Conferma per eliminare l'agente.
Passaggi successivi
- Scopri di più sugli agenti di dati.
- Scopri come ispezionare e chiamare un agente dati.