pt-online-schema-change 的核心作用是不锁表、不中断业务,而非加速 alter table;它通过影子表+触发器机制实现在线变更,适用于 mysql 5.5 至 8.0 中索引增删、字段类型修改等原生 ddl 仍需锁表的场景。

pt-online-schema-change 不是“加速”ALTER TABLE,而是绕过它——它根本不用原生 DDL 执行路径,所以不存在“加速”一说;真正的作用是「不锁表、不中断业务」。如果你的 MySQL 是 8.0.12+,且只是加列,ALTER TABLE ... ALGORITHM=INSTANT 才是真快;但只要涉及索引增删、字段类型变更、主键调整或分区改造,pt-online-schema-change 仍是不可替代的方案。
为什么不能直接用 ALTER TABLE?
MySQL 5.7 及更早版本中,ALTER TABLE 对大表(比如千万级以上)几乎必然触发全表拷贝 + 排他锁,期间所有 INSERT/UPDATE/DELETE 都会阻塞,SELECT 在某些隔离级别下也可能被卡住。即使 8.0 的 Online DDL,也仅对部分操作支持无锁(如 ADD COLUMN),而 DROP INDEX、MODIFY COLUMN、CHANGE COLUMN 等仍需元数据锁或重建表。
常见错误现象包括:
- 执行
ALTER TABLE后,应用报错Lock wait timeout exceeded - 监控显示
Threads_running持续飙升,innodb_row_lock_time暴涨 - 主从延迟突增,甚至复制中断(因 DDL 语句在从库回放慢)
pt-online-schema-change 的核心参数怎么配?
不是所有参数都该默认值跑,尤其在生产环境。关键参数差异直接影响是否成功、多慢、会不会拖垮主库:
-
--chunk-size=1000:默认 1000 行/批,大表建议调到5000~10000(减少触发器调用次数),但别超过100000,否则单次更新时间过长,易触发--max-lag中断 -
--max-lag=3s:默认 1s,建议设为3s或5s,避免因从库短暂抖动导致工具自动暂停;若从库长期延迟 >5s,先治本(查慢 SQL、网络、IO)再跑pt-osc -
--critical-load="Threads_running=256":当SHOW STATUS LIKE 'Threads_running'超过该值,工具立即退出,防止雪崩;生产建议设为当前峰值的 1.2 倍,而非拍脑袋填 512 -
--check-interval=5:每 5 秒检查一次延迟和负载,太短增加系统开销,太长响应滞后,5~10 秒较平衡 -
--no-check-alter:慎用!仅当你确认--alter语法合法且兼容目标 MySQL 版本时跳过语法校验;否则可能中途失败,留下脏数据和残留触发器
执行前必须做的三件事
跳过任何一项,都可能导致失败后难回滚、主从不一致、或触发器堆积拖垮性能:
- 用
--dry-run模拟全流程:pt-online-schema-change --dry-run --alter="ADD COLUMN status TINYINT" D=test,t=users—— 它会检查权限、外键、唯一索引、触发器冲突等,但不建影子表、不启触发器 - 确认目标表没有
FULLTEXT索引或SPATIAL索引(pt-osc不支持);若有,必须先DROP,改完再加 - 确保主库 binlog_format=ROW(
STATEMENT格式下触发器同步不可靠),且从库relay_log_recovery=ON(防意外中断后复制错乱)
容易被忽略的坑:字符集、时区与分区表
这些细节不会报错,但会导致数据静默异常:
- 如果原表用
utf8mb4_0900_ai_ci,但没显式指定--charset=utf8mb4,pt-osc可能按客户端默认字符集建影子表,导致排序规则不一致、索引失效 - 涉及
TIMESTAMP字段时,务必确认time_zone设置一致(主从、连接 session),否则createtime字段在影子表中写入值可能偏移 - 转分区表(如 RANGE 分区)时,
--alter中的表达式必须能在所有 MySQL 版本中求值,例如year(createtime)*100+month(createtime)在 5.7 和 8.0 下行为一致;但DATE_FORMAT(createtime, '%Y%m')在某些旧版本可能返回空字符串,导致分区键为 NULL,数据进不了任何分区
最麻烦的不是失败,而是“看似成功”——表名换了、数据看着也对,但某类查询变慢、某批导入数据丢失、或者某天凌晨从库突然报错 Partition p202305 is not defined。这类问题往往要翻日志、比对影子表建表语句、甚至抓包看触发器实际执行内容才能定位。











