Primeros pasos con Key Visualizer

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:

  1. En la página de Spanner de la consola de Google Cloud, selecciona una instancia.

  2. Selecciona una base de datos para investigar.

  3. 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 de spanner_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.

  4. 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?