MySQL / 系统课时
监控 ALTER 执行进度
监控 ALTER 执行进度
长时间 ALTER TABLE 最危险的不是“慢”,而是不知道它正在做什么、是否还在前进。本节使用 Performance Schema 的 stage 事件定位 InnoDB ALTER 当前阶段,并结合 WORK_COMPLETED 与 WORK_ESTIMATED 判断工作量趋势。
学习目标
- 启用 InnoDB ALTER 所需的 stage instruments 与 consumer
- 从
events_stages_current识别当前阶段并计算可用的进度比例 - 正确解释
WORK_ESTIMATED会变化、当前事件可能为空等边界情况
先把 ALTER 阶段观测打开
InnoDB 为 ALTER 暴露多类 stage,例如读取主键并内部排序、merge sort、插入索引、应用在线 DML 日志、flush 和结束阶段。要看到这些事件,需要同时启用对应 instrument 与 stage consumer。
UPDATE performance_schema.setup_instruments
SET ENABLED = 'YES', TIMED = 'YES'
WHERE NAME LIKE 'stage/innodb/alter table%';
UPDATE performance_schema.setup_consumers
SET ENABLED = 'YES'
WHERE NAME LIKE 'events_stages_%';
SELECT NAME, ENABLED, TIMED
FROM performance_schema.setup_instruments
WHERE NAME LIKE 'stage/innodb/alter table%'
ORDER BY NAME;预期结果
NAME ENABLED TIMED
stage/innodb/alter table (end) YES YES
stage/innodb/alter table (flush) YES YES
stage/innodb/alter table (insert) YES YES
stage/innodb/alter table (log apply index) YES YES
stage/innodb/alter table (log apply table) YES YES
stage/innodb/alter table (merge sort) YES YES
stage/innodb/alter table (read PK and internal sort) YES YES如果查询不到这些 instrument,应先确认目标实例的 MySQL 版本、存储引擎和 Performance Schema 是否启用,而不是继续假设监控 SQL 有问题。
用当前 stage 看“正在做什么”
在执行 ALTER 的会话保持运行时,从另一个会话查询 events_stages_current。连接 performance_schema.threads 后,可以把内部 THREAD_ID 映射成客户端更熟悉的 PROCESSLIST_ID。
SELECT
t.PROCESSLIST_ID,
s.EVENT_NAME,
s.WORK_COMPLETED,
s.WORK_ESTIMATED,
ROUND(
100 * s.WORK_COMPLETED / NULLIF(s.WORK_ESTIMATED, 0),
1
) AS progress_pct
FROM performance_schema.events_stages_current AS s
JOIN performance_schema.threads AS t
ON t.THREAD_ID = s.THREAD_ID
WHERE s.EVENT_NAME LIKE 'stage/innodb/alter table%'
ORDER BY t.PROCESSLIST_ID;预期结果
PROCESSLIST_ID EVENT_NAME WORK_COMPLETED WORK_ESTIMATED progress_pct
<ID> stage/innodb/alter table (read PK and internal sort) <VALUE> <VALUE> <VALUE><ID> 与 <VALUE> 都是运行时值。若 ALTER 已经完成,events_stages_current 可能没有对应行;这时应查 events_stages_history 或 events_stages_history_long,而不是把空结果直接判定为“监控失效”。

百分比只能表示工作量趋势
当某个 stage 同时提供 WORK_COMPLETED 与非零 WORK_ESTIMATED 时,可以计算完成比例。但这两个字段的单位由 instrument 自己定义,可能是页、行或其他抽象工作量;它不是统一的“已处理行数”。
更重要的是,InnoDB ALTER 的 WORK_ESTIMATED 会随着真实工作被发现而修正。因此,progress_pct 适合回答“是否持续前进”和“当前大致处在哪个阶段”,不适合直接换算成固定 ETA。看到百分比停顿时,应连续采样几次,再结合磁盘 IO、锁等待和当前 stage 判断是否真的卡住。
用阶段变化区分慢与卡住
若 WORK_COMPLETED 持续增加,说明 ALTER 仍在推进;进入 merge sort 或 insert 往往意味着索引构建工作正在进行;进入 log apply table 时,执行时积累的并发 DML 需要被应用,写入越活跃,这一阶段越可能拉长。
如果连续采样中 stage 与计数长期不变,再检查 performance_schema.metadata_locks、事务与系统资源。反过来,若 WORK_ESTIMATED 变大但 WORK_COMPLETED 同样持续上升,不应仅因百分比下降就中止 DDL——这可能只是估算值被修正。
监控 ALTER 的正确姿势是把“当前阶段、完成工作量、估算工作量、锁与资源”放在一起看。单个百分比只能提供趋势,阶段切换和连续采样才足以判断一次在线 DDL 是正常推进、等待资源,还是已经进入需要干预的故障状态。