Gérer les ensembles de contexte dans Cloud SQL pour PostgreSQL Studio

MySQL | PostgreSQL | SQL Server

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service et aux Conditions supplémentaires pour les produits d'IA générative en version preview. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Pour en savoir plus sur l'accès à cette version, consultez la page de demande d'accès.

Ce document explique comment créer des ensembles de contexte dans Cloud SQL pour PostgreSQL Studio à l'aide d'un fichier d'ensemble de contexte. Les noms des ensembles de contexte doivent être uniques dans une base de données.

Pour en savoir plus sur les ensembles de contexte, consultez Présentation des ensembles de contexte.

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 :

• API Data Analytics avec Gemini
• API Gemini pour Google Cloud
• API Dataplex Universal Catalog

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.

Ce tutoriel nécessite que vous disposiez d'une base de données dans votre instance Cloud SQL. Pour en savoir plus, consultez Créer une base de données sur l'instance Cloud SQL.

Rôles et autorisations nécessaires

• Ajoutez un compte d'utilisateur ou de service IAM à l'instance. Pour en savoir plus, consultez Gérer les utilisateurs avec l'authentification IAM pour les bases de données Cloud SQL.
• Accordez les rôles cloudsql.studioUser, cloudsql.instanceUser et geminidataanalytics.queryDataUser à 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 de lecture seule sur la base de données à un utilisateur ou à un compte de service IAM en vous connectant en tant qu'utilisateur disposant de droits de super-utilisateur, comme l'utilisateur postgres.
  
  GRANT SELECT ON ALL TABLES IN SCHEMA public TO USER_NAME;
  
  Remplacez USER_NAME par l'adresse e-mail de l'utilisateur. Vous devez placer l'adresse e-mail entre guillemets, car elle contient des caractères spéciaux (@ et .).
  
  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 config set project PROJECT_ID
gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• INSTANCE_ID : ID de votre instance Cloud SQL.

Pour effectuer les étapes de ce tutoriel, connectez-vous à Google Cloud, puis authentifiez-vous auprès de la base de données à l'aide de l'authentification IAM.

Créer un ensemble de contextes

Pour créer un ensemble de contexte, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification IAM.

5. Dans le volet Explorateur, à côté de Ensembles de contexte, cliquez sur Afficher les actions.

6. Cliquez sur Créer un ensemble de contexte.

7. Dans Nom de l'ensemble de contextes, indiquez un nom unique pour l'ensemble de contextes. Le nom de l'ensemble de contexte est sensible à la casse et peut contenir des lettres, des chiffres, des traits d'union et des traits de soulignement.

8. Facultatif. Dans Description de l'ensemble de contexte, ajoutez une description pour votre ensemble de contexte.

9. Cliquez sur Créer.

Remarque : La création du premier ensemble de contextes dans un projet peut prendre plusieurs minutes.

Créer des ensembles de contextes

Après avoir créé un ensemble de contextes, suivez les étapes décrites dans Créer des contextes à l'aide de Gemini CLI pour créer un fichier d'ensemble de contextes. Vous pouvez ensuite modifier votre ensemble de contexte pour importer le fichier d'ensemble de contexte.

Modifier un ensemble de contextes

Pour modifier un ensemble de contextes, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management.

5. Dans le volet Explorateur, à côté de Ensembles de contexte, cliquez sur Afficher les actions.

6. Cliquez sur Modifier l'ensemble de contexte.

7. Facultatif : modifiez la description de l'ensemble de contexte.

8. Cliquez sur Parcourir dans la section Importer un fichier d'ensemble de contexte, puis sélectionnez le fichier d'ensemble de contexte.

9. Cliquez sur Enregistrer.

Supprimer un ensemble de contextes

Pour supprimer un ensemble de contexte, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Cloud SQL.

   Accéder à Cloud SQL

2. Sélectionnez une instance dans la liste.

3. Dans le menu de navigation, cliquez sur Cloud SQL Studio.

4. Connectez-vous à Studio à l'aide de l'authentification Identity and Access Management.

5. Dans le volet Explorateur, à côté de Ensembles de contexte, cliquez sur Afficher les actions.

6. Cliquez sur Supprimer l'ensemble de contexte.

7. Dans la boîte de dialogue de confirmation Supprimer l'ensemble de contexte, saisissez le nom de l'ensemble de contexte.

8. Cliquez sur Confirmer pour supprimer l'ensemble de contexte.

Remarque : Avant de supprimer une base de données, vous devez supprimer tous les ensembles de contexte associés.

Étapes suivantes

• En savoir plus sur les ensembles de contexte
• Découvrez comment tester un ensemble de contexte.
• Découvrez comment créer des contextes à l'aide de Gemini CLI.