大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:TRAFFIC REPLAY

· 52CE 我爱测

# TRAFFIC REPLAY TiDB v9.0.0 引入了 语法,用于向集群中所有 TiProxy 实例发送请求,让 TiProxy 从流量文件回放流量到 TiDB。 回放流量需要当前用户具有 或 权限。 支持以下选项: - :(必填)指定回放时使用的 TiDB 用户名。 - :(可选)指定以上用户名的密码,默认为空字符串 。 - :(可选)指定回放速率的倍数,范围为 ,默认为 ,表示原速回放。 - :(可选)指定是否仅回放只读

TRAFFIC REPLAY

TiDB v9.0.0 引入了 TRAFFIC REPLAY 语法,用于向集群中所有 TiProxy 实例发送请求,让 TiProxy 从流量文件回放流量到 TiDB。

回放流量需要当前用户具有 SUPER 或 TRAFFIC_REPLAY_ADMIN 权限。

TRAFFIC REPLAY 支持以下选项:

  • USER:(必填)指定回放时使用的 TiDB 用户名。
  • PASSWORD:(可选)指定以上用户名的密码,默认为空字符串 ""。
  • SPEED:(可选)指定回放速率的倍数,范围为 [0.1, 10],默认为 1,表示原速回放。
  • READ_ONLY:(可选)指定是否仅回放只读 SQL 语句。true 表示仅回放只读 SQL 语句,false 表示回放只读和写入 SQL 语句。默认值为 false。

语法图

TrafficStmt ::=
    "TRAFFIC" "REPLAY" "FROM" stringLit TrafficReplayOptList

TrafficReplayOptList ::=
    TrafficReplayOpt
|   TrafficReplayOptList TrafficReplayOpt

TrafficReplayOpt ::=
    "USER" EqOpt stringLit
|   "PASSWORD" EqOpt stringLit
|   "SPEED" EqOpt NumLiteral
|   "READ_ONLY" EqOpt Boolean

示例

从 TiProxy 实例的本地 /tmp/traffic 目录回放流量,使用 TiDB 用户 u1 回放,其密码为 "123456":

TRAFFIC REPLAY FROM "/tmp/traffic" USER="u1" PASSWORD="123456";

从存放在 S3 的流量文件回放流量:

TRAFFIC REPLAY FROM "s3://external/traffic?access-key=${access-key}&secret-access-key=${secret-access-key}" USER="u1" PASSWORD="123456";

2 倍速回放流量:

TRAFFIC REPLAY FROM "/tmp/traffic" USER="u1" PASSWORD="123456" SPEED=2;

仅回放只读语句,不回放写入语句:

TRAFFIC REPLAY FROM "/tmp/traffic" USER="u1" PASSWORD="123456" READONLY=true;

MySQL 兼容性

该语句是 TiDB 对 MySQL 语法的扩展。

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。