Key Visualizer 使用入门

概览

默认情况下,Key Visualizer 处于启用状态。

在某些情况下,Key Visualizer 可能无法立即提供数据。

  • 新创建的数据库的存储和流量统计信息可能无法立即提供。
  • 新插入行的流量统计信息可能会归因于现有键范围。

Key Visualizer 接口

您可以通过 Google Cloud Console 访问 Key Visualizer 工具。

如需访问 Key Visualizer,请执行以下操作:

  1. 从 Cloud Console 的 Spanner 页面中,选择一个实例。

  2. 选择要调查的数据库。

  3. 在左侧导航菜单的监控下,选择 Key Visualizer

停用 Key Visualizer

Key Visualizer 启用由 enable_key_visualizer 数据库选项控制。默认值为 true

如要停用 Key Visualizer,请将 enable_key_visualizer 数据库选项的值设置为 false。用于停用 Key Visualizer 的 DDL 语法如下:

ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)

如果您的数据库 ID 包含字母、数字或下划线以外的字符,请务必用反引号 (`) 将 ID 括起来。

该语句可以使用 gcloud 命令发送,也可以在 UpdateDatabaseDdl gRPC/REST 请求中发送。例如:

gcloud spanner databases ddl update database_id --instance=instance_id \
    --ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'

明确设置 enable_key_visualizer 的值后,您可以点击概览页面中的 SHOW EQUIVALENT DDL 或使用 ddl describe gcloud 命令检查其值:

gcloud spanner databases ddl describe `database_id` --instance=instance_id

重新启用 Key Visualizer

如要重新启用 Key Visualizer,请按照停用 Key Visualizer 中的说明操作,将 enable_key_visualizer 数据库选项的值设置为 true

首次为数据库重新启用 Key Visualizer 热图时,Cloud Spanner 收集指标的前几分钟的 Key Visualizer 热图将为空。

后续步骤