pt-osc在mysql 5.7中必须依赖触发器,因其通过在原表创建insert/update/delete三类触发器,将实时变更同步至影子表,从而绕过原生online ddl对修改列类型、重命名字段等操作的限制,实现真正在线变更。

pt-osc 在 MySQL 5.7 中能实现真正的在线 DDL,但前提是必须满足触发器、主键、权限和负载控制这四个硬性条件,缺一不可。
为什么 pt-osc 在 5.7 上必须依赖触发器
MySQL 5.7 原生 Online DDL 虽支持 LOCK=NONE,但仅限于部分操作(如加二级索引、改默认值);而修改列类型、重命名字段、删除外键等仍需 LOCK=SHARED 或直接失败。pt-osc 绕过原生限制的核心机制就是触发器:它在原表上创建 INSERT、UPDATE、DELETE 三类触发器,把所有变更实时同步到影子表。这意味着只要原表支持触发器(InnoDB 表、非临时表、无递归触发器限制),就能覆盖几乎所有 DDL 场景。
常见错误现象:ERROR 1419 (HY000): You do not have the SUPER privilege and binary logging is enabled —— 这不是权限不足,而是 MySQL 5.7 默认开启 binlog 且未配置 log_bin_trust_function_creators=1,导致无法创建触发器。必须在 my.cnf 中添加该参数并重启,或动态执行 SET GLOBAL log_bin_trust_function_creators = 1(需 SUPER 权限)。
主键或唯一索引是 pt-osc 的强制前提
pt-osc 分块拷贝数据时,依赖主键或唯一索引做 chunk 切分(如 --chunk-index=id)。没有它,工具会拒绝执行,并报错 FATAL Cannot determine a usable index for chunking。
- 若表无主键但有唯一索引,可用
--chunk-index=uk_col显式指定 - 若连唯一索引都没有(比如日志表),必须先加唯一约束或改用 gh-ost(它基于 binlog 解析,不依赖索引)
- 注意:添加主键本身不能用 pt-osc 执行,因为触发器 DELETE 逻辑依赖旧表结构中的主键列;此时应先用原生
ALTER TABLE ... ADD PRIMARY KEY(需业务低峰期)
权限和参数配置最容易被跳过的坑
pt-osc 不是只读工具,它需要写权限、触发器权限、RENAME 权限,还可能涉及从库延迟判断。最小必要权限组合是:
CREATE, DROP, ALTER, INSERT, DELETE, SELECT, UPDATE, PROCESS, REPLICATION SLAVE, TRIGGER
实操中常漏掉 PROCESS(用于检查 Threads_running)和 REPLICATION SLAVE(用于读取 Seconds_Behind_Master)。另外两个关键参数必须显式设置:
-
--max-lag=1:避免从库延迟过大导致切表失败;不设则默认为 1 秒,但若从库已延迟 2 秒,pt-osc 会一直暂停 -
--check-interval=1:配合--max-lag使用,每 1 秒检查一次延迟;不设则默认 1 秒,但某些高负载环境建议调大到 2~3 秒,减少监控压力
典型命令示例:
pt-online-schema-change --user=pt_osc --password=xxx D=test,t=user_info --alter "ADD COLUMN status TINYINT DEFAULT 0" --max-lag=1 --check-interval=2 --execute
切表瞬间的原子性风险与应对
pt-osc 的最后一步是 RENAME TABLE user_info TO user_info_old, _user_info_new TO user_info。这个操作本身是原子的,但前面的触发器删除和后面的旧表清理不是。如果在 RENAME 后、触发器删除前发生崩溃,原表将残留触发器,后续 DML 可能写入已废弃的 _user_info_new 表。
规避方式只有两个:
– 严格确保执行期间无 kill -9 或 mysqld 异常退出
– 执行后立即验证:SHOW TRIGGERS LIKE 'user_info' 应返回空;SELECT COUNT(*) FROM user_info_old 应为原表行数(确认未丢失)
真正容易被忽略的是:pt-osc 不校验新旧表数据一致性。即使触发器同步正常,若原表存在未提交事务或隔离级别异常(如 READ UNCOMMITTED),可能导致影子表漏数据。上线前务必用 pt-table-checksum 对比校验。











