Gérer les ensembles de contexte dans AlloyDB Studio

Ce document explique comment créer des ensembles de contexte dans AlloyDB 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 :

Préparer un cluster, une instance et une base de données AlloyDB pour PostgreSQL

Assurez-vous d'avoir accès à un cluster et à une instance AlloyDB existants, ou créez-en un.
Pour suivre ce tutoriel, vous devez disposer d'une base de données dans votre instance AlloyDB. Pour en savoir plus, consultez Créer une base de données.

Rôles et autorisations nécessaires

  • Ajoutez un compte d'utilisateur ou de service Identity and Access Management (IAM) au cluster au niveau de la base de données. Pour en savoir plus, consultez Gérer les utilisateurs de la base de données.
  • Accordez les rôles alloydb.databaseUser, serviceusage.serviceUsageConsumer 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.
  • Pour créer, importer et gérer des ensembles de contexte, attribuez le rôle Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor) ou Administrateur de catalogue Dataplex (roles/dataplex.catalogAdmin) à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Autorisations des ensembles de contexte.

Accorder l'autorisation executesql à l'instance AlloyDB pour PostgreSQL

Pour accorder l'autorisation executesql à l'instance AlloyDB pour PostgreSQL et définir le paramètre d'instance data_api_access sur la valeur ALLOW_DATA_API, utilisez la commande curl suivante : 
   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",
     }'
Remplacez les éléments suivants :
  • PROJECT_ID : ID de votre projet Google Cloud .
  • LOCATION : région dans laquelle se trouve votre cluster AlloyDB.
  • CLUSTER_ID : ID de votre cluster AlloyDB.
  • INSTANCE_ID : ID de votre instance AlloyDB.
Pour suivre 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 AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB 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 contexte, indiquez un nom unique pour l'ensemble de contexte. 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.

Créer des ensembles de contexte

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 contexte, procédez comme suit :

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

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB 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 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 contexte

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

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

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB 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 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.

Étapes suivantes