Descripción general
Key Visualizer está habilitado de forma predeterminada.
Hay algunas situaciones en las que los datos pueden no estar disponibles de inmediato en Key Visualizer.
- Es posible que las estadísticas de almacenamiento y tráfico de las bases de datos recién creadas no estén disponibles de inmediato.
- Las estadísticas de tráfico de las filas recién insertadas pueden atribuirse a los rangos de claves existentes.
Antes de comenzar
Para ver Key Visualizer, necesitas lo siguiente:
Si eres un usuario de control de acceso detallado, debes tener acceso a la función del sistema
spanner_sys_reader
o a una de sus funciones de miembro.Si no eres un usuario de control de acceso detallado, necesitas el siguiente permiso de administración de identidades y accesos (IAM):
spanner.databases.read
Para obtener más información, consulta Acerca del control de acceso detallado y Funciones detalladas del sistema de control de acceso.
La interfaz de Key Visualizer
Puedes acceder a la herramienta Key Visualizer desde la consola de Google Cloud.
Para acceder a Key Visualizer, haz lo siguiente:
En la página de Spanner de la consola de Google Cloud, selecciona una instancia.
Selecciona una base de datos para investigar.
Solo usuarios de control de acceso detallado: en la página Descripción general de la base de datos, en el campo Función actual, especifica la función del sistema
spanner_sys_reader
o una función que sea miembro despanner_sys_reader
(o que sea descendiente de un miembro de este).Para obtener más información, consulta Acerca del control de acceso detallado y Funciones detalladas del sistema de control de acceso.
En el menú de navegación de la izquierda, en Observabilidad, selecciona Key Visualizer.
Inhabilitar Key Visualizer
La habilitación de Key Visualizer se controla mediante la opción de base de datos enable_key_visualizer
. El valor predeterminado es true
.
Para inhabilitar Key Visualizer, establece el valor de la opción de base de datos enable_key_visualizer
en false
. La sintaxis de DDL para inhabilitar Key Visualizer es la siguiente:
ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)
Si el ID de la base de datos contiene caracteres que no son letras, números o guiones bajos, asegúrate de encerrar el ID con acentos graves (``).
La declaración se puede enviar con un comando de gcloud o en una solicitud UpdateDatabaseDdl
de gRPC/REST. Por ejemplo:
gcloud spanner databases ddl update database_id --instance=instance_id \
--ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'
Una vez que hayas establecido el valor de enable_key_visualizer
de forma explícita, puedes verificar
su valor si haces clic en MOSTRAR DDL EQUIVALENT en la página de descripción general o usa el
comando ddl describe
de gcloud:
gcloud spanner databases ddl describe `database_id` --instance=instance_id
Volver a habilitar Key Visualizer
Para volver a habilitar Key Visualizer, sigue las instrucciones en Inhabilita Key Visualizer y configura el valor de la opción de base de datos enable_key_visualizer
como true
.
Cuando se vuelva a habilitar para una base de datos, el mapa de calor de Key Visualizer estará vacío durante los primeros minutos mientras Cloud Spanner recopila métricas.
¿Qué sigue?
- Aprende a reconocer patrones comunes en mapas de calor.
- Descubre cómo explorar un mapa de calor en profundidad.
- Obtén información sobre las métricas que puedes ver en un mapa de calor.