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.

Lorsque vous utilisez l'agent d'ingénierie contextuelle, il peut créer et importer automatiquement des ensembles de contextes à partir de votre CLI. Ce document explique comment créer, modifier et supprimer des ensembles de contexte dans Spanner Studio lorsque vous souhaitez utiliser une interface visuelle dans la console Google Cloud pour gérer les fichiers d'ensembles de contexte. Lorsque vous créez un ensemble de contexte dans Spanner Studio, Spanner Studio le stocke dans le groupe d'ensembles de contexte default du projet pour la région sélectionnée et l'associe à la base de données actuelle. Les noms des ensembles de contexte (et les ID d'ensembles de contexte dérivés) doivent être uniques dans le groupe d'ensembles de contexte default du projet pour une région donnée, sur l'ensemble des bases de données et des instances. Dans Spanner Studio, la création d'un ensemble de contexte dont l'ID dérivé existe déjà échoue à la validation. Pour écraser son contenu tout en conservant ses associations de base de données, modifiez l'ensemble de contexte existant. L'importation directe via l'agent d'ingénierie de contexte ou l'API Dataplex avec un ID d'ensemble de contextes existant remplace son contenu et, si spécifié, ses associations de base de données.

La liste Ensembles de contexte de Spanner Studio n'affiche que les ensembles de contexte du groupe d'ensembles de contexte default dans toutes les régions prises en charge associées à la base de données actuelle. Les ensembles de contexte créés pour une autre base de données ou créés via l'API sans associer la ressource de base de données dans databases (ou dans un groupe d'ensembles de contexte personnalisé) n'apparaissent pas dans la liste Spanner Studio.

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

Avant de commencer

Avant de créer ou d'importer un ensemble de contextes, assurez-vous de remplir les conditions préalables suivantes.

Les ensembles de contexte peuvent être créés dans les régions us-central1, us-east1, europe-west4 et asia-southeast1.

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.

Rôles et autorisations nécessaires

• Ajoutez un compte d'utilisateur ou de service IAM à l'instance. Pour en savoir plus, consultez Appliquer des rôles IAM.
• Attribuez les rôles roles/spanner.databaseReader, roles/serviceusage.serviceUsageConsumer et roles/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.

Avertissement : Tous les ensembles de contexte associés à une base de données sont visibles par tous les utilisateurs disposant d'un accès en lecture à cette base de données. Lorsque les utilisateurs disposent d'un accès plus restreint à la base de données, par exemple avec le contrôle ultraprécis des accès de Spanner, ils peuvent potentiellement découvrir d'autres champs et tables à partir de l'ensemble de contexte.

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. Dans Spanner Studio, le nom doit comporter entre 4 et 30 caractères et ne peut pas commencer par un espace. Studio dérive l'ID de l'ensemble de contextes en convertissant le nom en minuscules et en remplaçant les caractères non alphanumériques par des traits d'union (-). L'ID de l'ensemble de contextes dérivé doit être unique dans le groupe d'ensembles de contextes default du projet pour la région sélectionnée. Par exemple, le nom de l'ensemble de contextes querydata_e2e_test est associé à l'ID d'ensemble de contextes querydata-e2e-test. Lorsque vous importez un ensemble de contextes directement à l'aide de l'agent d'ingénierie de contexte ou de l'API Dataplex, l'ID de l'ensemble de contextes est sensible à la casse, ne peut pas contenir de barres obliques (/) et n'est pas limité à 4 à 30 caractères ni à des caractères alphanumériques, des traits d'union et des traits de soulignement.

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. Facultatif. Pour choisir une région pour l'ensemble de contextes, cliquez sur Afficher les options avancées, puis sélectionnez une région dans Sélectionner un emplacement (par défaut, us-east1 à chaque création). Si vous choisissez une région autre que us-east1, sélectionnez-la avant de saisir le nom de l'ensemble de contextes afin que Spanner Studio valide l'unicité du nom dans cette région.

10. Cliquez sur Créer.

Remarque : La création d'un ensemble de contexte à partir de Spanner Studio peut prendre quelques minutes, le temps que Spanner Studio traite l'ensemble de contexte. La création ou l'importation d'un ensemble de contextes via l'agent d'ingénierie contextuelle ou l'API Dataplex ne prend généralement que quelques secondes.

Créer des ensembles de contextes

Si vous avez créé un ensemble de contextes vide dans Studio ou si vous souhaitez en mettre à jour un existant, suivez les étapes de la section Créer et optimiser des ensembles de contextes avec l'agent d'ingénierie de contexte pour générer et optimiser un fichier d'ensemble de contextes. L'agent d'ingénierie contextuelle peut créer et importer votre ensemble de contexte directement depuis la CLI. Vous pouvez également modifier votre ensemble de contexte dans Studio pour l'importer manuellement.

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 contextes, puis sélectionnez le fichier d'ensemble de contextes.

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 : La suppression d'une base de données ne supprime pas ses ensembles de contexte. Pour éviter les ensembles de contextes orphelins qui exposent toujours les détails du schéma, supprimez-les avant de supprimer la base de données.

Étapes suivantes

• En savoir plus sur les ensembles de contexte
• Découvrez comment tester QueryData dans Spanner Studio.
• Découvrez comment créer et optimiser des ensembles de contextes avec l'agent d'ingénierie de contexte.
• Découvrez comment intégrer QueryData à une application.