Key Visualizer est activé par défaut dans Spanner.
Avant de commencer
Pour afficher Key Visualizer, vous avez besoin des ressources Identity and Access Management suivantes (IAM):
spanner.databases.read
Si vous utilisez le contrôle des accès précis, vous devez disposer des autorisations suivantes :
- le rôle système
spanner_sys_reader
ou l'un de ses rôles de membre.
Pour en savoir plus, consultez les pages À propos du contrôle des accès ultraprécis et Rôles système de contrôle des accès ultraprécis.
Accéder à l'interface Key Visualizer
Vous accédez à l'outil Key Visualizer à partir de la console Google Cloud.
Pour accéder à Key Visualizer, procédez comme suit :
À partir de la page Spanner du dans la console Google Cloud, sélectionnez une instance.
Sélectionnez une base de données à examiner.
Dans le menu de navigation, sous Observabilité, sélectionnez Key Visualizer.
Désactiver Key Visualizer
Key Visualizer est contrôlé par enable_key_visualizer
base de données. La valeur par défaut est true
.
Pour désactiver Key Visualizer, définissez la valeur de l'option de base de données enable_key_visualizer
sur false
. La syntaxe LDD permettant de désactiver Key Visualizer est la suivante :
ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)
Si l'ID de votre base de données contient des caractères autres que des lettres, des chiffres ou des traits de soulignement, veillez à l'entourer par des accents graves (``).
L'instruction peut être envoyée à l'aide d'une commande gcloud ou dans une requête gRPC/REST UpdateDatabaseDdl
. Exemple :
gcloud spanner databases ddl update database_id --instance=instance_id \
--ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'
Une fois que vous avez explicitement défini la valeur de enable_key_visualizer
, vous pouvez vérifier sa valeur en cliquant sur AFFICHER LES INSTRUCTIONS LDD ÉQUIVALENTES dans la page de présentation, ou en utilisant la commande gcloud ddl describe
:
gcloud spanner databases ddl describe `database_id` --instance=instance_id
Réactiver Key Visualizer
Pour réactiver Key Visualizer, suivez les instructions précédentes en définissant la valeur de l'option de base de données enable_key_visualizer
sur true
.
Lors de la première réactivation d'une base de données, la carte de densité Key Visualizer sera vide. pendant les premières minutes, le temps que Spanner collecte des métriques.
Étape suivante
- Apprenez à reconnaître les modèles courants dans les cartes de densité.
- Découvrez comment explorer les cartes de densité en profondeur.
- Informez-vous sur les métriques que vous pouvez afficher dans une carte de densité.