Ce document explique comment créer un agent de données dans Cloud SQL Studio pour MySQL à l'aide d'un fichier de contexte d'agent. Un agent de données est associé à un seul fichier de contexte d'agent.
Pour en savoir plus sur les agents de données, consultez Présentation des agents de données.Avant de commencer
Avant de créer un agent, remplissez les conditions préalables suivantes.
Activer les services requis
Activez les services suivants pour votre projet :Préparer une instance Cloud SQL
- Assurez-vous d'avoir accès à une instance Cloud SQL existante ou créez-en une. Pour en savoir plus, consultez Créer des instances pour Cloud SQL.
- Assurez-vous de créer une base de données dans votre instance où vous créerez les tables. Pour en savoir plus, consultez Créer une base de données sur l'instance Cloud SQL.
Rôles et autorisations requis
- Ajoutez un compte d'utilisateur ou de service IAM au niveau de l'instance. Pour en savoir plus, consultez Ajouter une liaison de stratégie IAM à un utilisateur, un compte de service ou un groupe.
- Attribuez les rôles
cloudsql.studioUseretcloudsql.instanceUserà l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une association de stratégie IAM pour un projet. - Vous devez également accorder des droits sur la base de données à un utilisateur ou à un compte de service IAM en vous connectant en tant qu'utilisateur de la base de données avec mot de passe.
GRANT ALL PRIVILEGES ON * TO "IAM_USERNAME";.
Pour en savoir plus, consultez Accorder des droits sur une base de données à un utilisateur ou à un compte de service IAM individuel.
Accorder l'autorisation executesql à l'instance Cloud SQL
Pour accorder l'autorisation executesql à l'instance Cloud SQL et activer l'API Cloud SQL Data, exécutez la commande suivante :
gcloud components update gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API
INSTANCE_ID par l'ID de votre instance Cloud SQL.
Pour effectuer les étapes de ce tutoriel, connectez-vous à Cloud de Confiance by S3NS, puis authentifiez-vous auprès de la base de données à l'aide de l'authentification IAM.
Créer un agent de données
Pour créer un agent de données, procédez comme suit :
Dans la console Cloud de Confiance by S3NS , accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Create agent (Créer un agent).
Dans Nom de l'agent, indiquez un nom unique pour l'agent. Le nom de l'agent est sensible à la casse et peut contenir des lettres, des chiffres, des traits d'union et des traits de soulignement.
Facultatif. Dans Description de l'agent, ajoutez une description pour votre agent.
Facultatif. Cliquez sur Afficher les options avancées, puis sélectionnez une région pour stocker le contexte de l'agent dans Sélectionner un emplacement. Vous pouvez choisir parmi la liste suivante de régions compatibles :
us-central1us-east1europe-west4asia-southeast1
Cliquez sur Créer.
Créer le contexte de l'agent
Après avoir créé un agent, suivez les étapes décrites dans Créer des contextes à l'aide de la Gemini CLI pour créer un fichier de contexte d'agent. Vous pouvez ensuite modifier votre agent pour importer le fichier de contexte.
Modifier un agent
Pour modifier un agent de données, procédez comme suit :
Dans la console Cloud de Confiance , accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Modifier l'agent.
Facultatif : Modifiez la description de l'agent.
Cliquez sur Parcourir dans la section Importer le fichier de contexte de l'agent, puis sélectionnez le fichier de contexte de l'agent.
Cliquez sur Enregistrer.
Supprimer un agent de données
Pour supprimer un agent de données, procédez comme suit :
Dans la console Cloud de Confiance , accédez à la page Cloud SQL.
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Cloud SQL Studio.
Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management (IAM).
Dans le volet Explorateur, à côté de Agents de données, cliquez sur Afficher les actions.
Cliquez sur Supprimer l'agent.
Dans la boîte de dialogue de confirmation Supprimer l'agent, saisissez le nom de l'agent.
Cliquez sur Confirmer pour supprimer l'agent.
Étape suivante
- En savoir plus sur les agents de données
- Découvrez comment inspecter et appeler un agent de données.