访问 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。

首次为数据库重新启用时，在 Spanner 收集指标期间，Key Visualizer 热图在前几分钟内为空。

后续步骤