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。

sql
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;

预期结果

text
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。

sql
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;

预期结果

text
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,而不是把空结果直接判定为“监控失效”。

InnoDB ALTER 阶段与进度计数关系

百分比只能表示工作量趋势

当某个 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 是正常推进、等待资源,还是已经进入需要干预的故障状态。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

监控 ALTER 执行进度

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通