Gérer les ensembles de contexte dans AlloyDB Studio

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 plus d'informations sur l'accès à cette version, consultez la page de demande d'accès.

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

Pour en savoir plus sur les ensembles de contextes, consultez la présentation des ensembles de contextes.

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 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.
Ce tutoriel nécessite que vous disposiez d'une base de données dans votre instance AlloyDB. Pour en savoir plus, consultez la page Créer une base de données.

Rôles et autorisations requis

• 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.
• Attribuez les rôles alloydb.databaseUser, serviceusage.serviceUsageConsumer et geminidataanalytics.queryDataUser à l'utilisateur IAM au niveau du projet. Pour en savoir plus, consultez Ajouter une liaison de stratégie IAM pour un projet.

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 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 Google Cloud projet.
• LOCATION : région où 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 contextes, procédez comme suit :

1. Dans la Google Cloud console, 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 contextes, cliquez sur Afficher les actions.

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

7. Dans Nom de l'ensemble de contextes, indiquez un nom unique pour l'ensemble de contextes. Le nom de l'ensemble de contextes 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 contextes, ajoutez une description pour votre ensemble de contextes.

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 contextes pour importer le fichier d'ensemble de contextes.

Modifier un ensemble de contextes

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

1. Dans la Google Cloud console, 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 Identity and Access Management.

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

6. Cliquez sur Modifier l'ensemble de contextes.

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

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

9. Cliquez sur Enregistrer.

Supprimer un ensemble de contextes

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

1. Dans la Google Cloud console, 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 Identity and Access Management.

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

6. Cliquez sur Supprimer l'ensemble de contextes.

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

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

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

Étape suivante

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