Gérer les ensembles de contexte dans Spanner 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.

Remarque sur l'interface PostgreSQL : Les exemples de cette rubrique sont destinés aux bases de données utilisant le dialecte GoogleSQL. Cette fonctionnalité n'est pas compatible avec l'interface PostgreSQL.

Ce document explique comment créer des ensembles de contexte dans Spanner Studio à l'aide d'un fichier d'ensemble de contexte. Les noms des ensembles de contextes doivent être uniques au sein d'un projet.

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

Avant de commencer

Avant de créer un agent, assurez-vous de remplir 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 Knowledge Catalog

Préparer une instance Spanner

• Assurez-vous qu'une instance Spanner est disponible. Pour en savoir plus, consultez la page Créer une instance.
• 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 Spanner.

Pour suivre ce tutoriel, vous devez disposer d'une base de données dans votre instance Spanner. 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 IAM au cluster. Pour en savoir plus, consultez Appliquer des rôles IAM.
• Attribuez les rôles spanner.databaseReader 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.
• Pour créer, importer et gérer des ensembles de contextes, 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 contextes.
• Attribuez des rôles et des autorisations à l'utilisateur IAM au niveau du projet pour les bases de données requises.

Créer un ensemble de contextes

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

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

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

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

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

6. Dans Nom de l'ensemble de contexte, indiquez un nom unique pour l'ensemble de contexte. 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. Les noms doivent comporter entre 4 et 30 caractères.

   L'ID de l'ensemble de contextes est dérivé du nom de l'ensemble de contextes, mais n'est pas nécessairement identique. Pour l'ID de l'ensemble de contextes, le nom de l'ensemble de contextes est converti en minuscules, et les caractères non alphanumériques sont remplacés par le caractère -. Par exemple, le nom de l'ensemble de contextes querydata_e2e_test est associé à l'ID d'ensemble de contextes querydata-e2e-test.

7. Facultatif. Dans Description de l'ensemble de contextes, ajoutez une description pour votre ensemble de contextes.

8. Facultatif. Pour importer un fichier d'ensemble de contexte, 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 Créer.

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

Créer des ensembles de contextes

Après avoir créé un ensemble de contextes, suivez les étapes de la section 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 "Spanner".

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

4. Cliquez sur Afficher les actions à côté de l'ensemble de contextes que vous souhaitez modifier.

5. Cliquez sur Modifier l'ensemble de contextes.

6. Facultatif. Modifiez la description de l'ensemble de contextes.

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

8. Cliquez sur Enregistrer.

Supprimer un ensemble de contextes

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

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

   Accéder à Spanner

2. Sélectionnez une instance dans la liste, puis une base de données.

3. Dans le menu de navigation, cliquez sur Spanner Studio.

4. Cliquez sur Afficher les actions à côté de l'ensemble de contextes que vous souhaitez supprimer.

5. Cliquez sur Supprimer l'ensemble de contexte.

6. Dans la boîte de dialogue de confirmation Supprimer l'ensemble de contextes, saisissez l'ID de l'ensemble de contextes.

7. 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 contexte associés à cette base de données.

Étapes suivantes

• 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.