访问 Key Visualizer

默认情况下,Spanner 中会启用 Key Visualizer。

准备工作

如需查看 Key Visualizer,您需要以下 Identity and Access Management (IAM) 权限

  • spanner.databases.read

如果您是精细访问权限控制用户,则必须已获得以下权限:

  • spanner_sys_reader 系统角色或某个成员角色。

如需了解详情,请参阅精细访问权限控制简介精细的访问权限控制系统角色

访问 Key Visualizer 界面

您可以从 Google Cloud 控制台访问 Key Visualizer 工具。

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

  1. 从 Google Cloud 控制台的 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,请按照上文中的说明操作,将 enable_key_visualizer 数据库选项的值设置为 true

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

后续步骤