默认情况下,Spanner 中会启用 Key Visualizer。
准备工作
如需查看 Key Visualizer,您需要以下 Identity and Access Management (IAM) 权限:
spanner.databases.read
如果您是精细访问权限控制用户,则必须已获得以下权限:
spanner_sys_reader
系统角色或某个成员角色。
如需了解详情,请参阅精细访问权限控制简介和 精细的访问权限控制系统角色。
访问 Key Visualizer 界面
您可以从 Google Cloud 控制台访问 Key Visualizer 工具。
如需访问 Key Visualizer,请执行以下操作:
从 Google Cloud 控制台的 Spanner 页面中,选择一个实例。
选择要调查的数据库。
在导航菜单的可观测性下,选择 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 收集指标期间开始的几分钟。
后续步骤
- 学会识别热图中的常见模式。
- 了解如何深入探索热图。
- 了解可以在热图中查看的指标。