Familiarisation avec Key Visualizer

Présentation

Key Visualizer est activé par défaut.

Dans certains cas, les données peuvent ne pas être immédiatement disponibles dans Key Visualizer.

  • Les statistiques de stockage et de trafic relatives aux bases de données nouvellement créées peuvent ne pas être disponibles immédiatement.
  • Les statistiques de trafic concernant les lignes nouvellement insérées peuvent être attribuées à des plages de clés existantes.

Avant de commencer

Pour afficher Key Visualizer, vous avez besoin des éléments suivants:

  • Si vous utilisez le contrôle des accès ultraprécis, vous devez avoir accès au rôle système spanner_sys_reader ou à l'un de ses rôles de membre.

  • Si vous n'êtes pas un utilisateur précis du contrôle des accès, vous devez disposer de l'autorisation Identity and Access Management (IAM) suivante:

    • spanner.databases.read

Pour en savoir plus, consultez les sections À propos du contrôle ultraprécis des accès et Rôles précis du système de contrôle des accès.

Interface Key Visualizer

Vous pouvez accéder à l'outil Key Visualizer depuis la console Google Cloud.

Pour accéder à Key Visualizer, procédez comme suit :

  1. Sur la page Spanner de la console Google Cloud, sélectionnez une instance.

  2. Sélectionnez une base de données à examiner.

  3. Contrôle précis des accès uniquement: sur la page Présentation de la base de données, dans le champ Rôle actuel, spécifiez le rôle système spanner_sys_reader ou un rôle appartenant à spanner_sys_reader (ou à un membre descendant d'un membre).

    Pour en savoir plus, consultez les sections À propos du contrôle ultraprécis des accès et Rôles précis du système de contrôle des accès.

  4. Dans le menu de navigation de gauche, sous Observabilité, sélectionnez Key Visualizer.

Désactiver Key Visualizer

L'activation de Key Visualizer est contrôlée par l'option de base de données enable_key_visualizer. 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 de la section Désactiver Key Visualizer en définissant la valeur de l'option de base de données enable_key_visualizer sur true.

Lorsque vous réactivez une base de données pour la première fois, la carte de densité de Key Visualizer est vide pendant les premières minutes, le temps que Spanner collecte les métriques.

Étapes suivantes