使用 PLAN REPLAYER 保存和恢复集群现场信息
用户在定位排查 TiDB 集群问题时,经常需要提供系统和查询计划相关的信息。为了帮助用户更方便地获取相关信息,更高效地排查集群问题,TiDB 在 v5.3.0 中引入了 PLAN REPLAYER
命令,用于“一键”保存和恢复现场问题的相关信息,提升查询计划问题诊断的效率,同时方便将问题归档管理。
PLAN REPLAYER
主要功能如下:
- 导出排查现场 TiDB 集群的相关信息,导出为 ZIP 格式的文件用于保存。
- 在任意 TiDB 集群上导入另一 TiDB 集群现场信息的 ZIP 文件。
你可以使用 PLAN REPLAYER
来保存 TiDB 集群的现场信息。导出接口如下:
TiDB 根据 sql-statement
整理出以下集群现场信息:
- TiDB 版本信息
- TiDB Session 系统变量
- TiDB 执行计划绑定信息(SQL Binding)
sql-statement
中所包含的表结构sql-statement
中所包含表的统计信息- 的结果
use test;
insert into t valuse(1,1), (2, 2), (3, 3);
analyze table t;
plan replayer dump explain select * from t;
PLAN REPLAYER DUMP
会将以上信息打包整理成 文件,并返回文件标识作为执行结果。该文件为一次性文件,被下载后 TiDB 会将其删除。
http://${tidb-server-ip}:${tidb-server-status-port}/plan_replayer/dump/${file_token}
其中,${tidb-server-ip}:${tidb-server-status-port}
是集群中任意 TiDB server 的地址。示例如下:
使用 PLAN REPLAYER
导入集群信息
有 PLAN REPLAYER
导出的 ZIP
文件后,用户便可以通过 PLAN REPLAYER
导入接口在任意 TiDB 集群上恢复另一集群地现场信息。语法如下:
PLAN REPLAYER LOAD 'file_name';
示例如下: