MySQL / 系统课时

设计 DDL 变更单

设计 DDL 变更单

DDL 变更单的目标不是记录“要执行哪条 ALTER”,而是把执行条件、风险证据、验证方式和失败处置一次写全。这样审批者能判断是否可上线,执行者能按单操作,出现异常时也能快速决定暂停、回退还是前向修复。

学习目标

  • 能定义一份可审计的 DDL 变更单必填项。
  • 能把表规模、MDL、容量和复制风险转成可核验的数据。
  • 能为变更写出明确的上线窗口、验证标准与失败处置方案。

先把变更意图写成可执行约束

一张合格的变更单至少要回答九件事:目标表是什么、执行哪条 SQL、要求什么 DDL 算法和锁级别、表有多大、当前是否存在长事务或 MDL 风险、磁盘是否够、复制链路是否健康、什么时候执行、成功和失败分别如何判断。

SQL 必须写最终版本,不能只写“给 orders 加索引”。对于希望在线执行的变更,还应显式记录期望的 ALGORITHM 与 LOCK,并说明这些要求在目标 MySQL 版本上是否已经验证。不同 DDL 动作、列类型和版本支持能力不同,不能仅凭“这是 MySQL 8.x”推断一定能 INSTANT 或 LOCK=NONE。

下面是一份可直接映射到发布系统字段的模板。它是数据结构示例,不是可执行配置。

yaml
change_id: "<ID>"
database: "app"
table: "orders"
ddl: "ALTER TABLE app.orders ADD INDEX idx_status_created_at (status, created_at), ALGORITHM=INPLACE, LOCK=NONE;"
required_algorithm: "INPLACE"
required_lock: "NONE"
table_size_gb: "<VALUE>"
estimated_rows: "<VALUE>"
mdl_risk:
  long_transaction_max_seconds: "<VALUE>"
  blocking_sessions: "<VALUE>"
capacity:
  disk_free_gb: "<VALUE>"
  temporary_space_budget_gb: "<VALUE>"
replication:
  max_replica_lag_seconds: "<VALUE>"
  unhealthy_replicas: "<VALUE>"
window:
  start: "<TIME>"
  stop_if_not_finished_by: "<TIME>"
validation:
  - "目标索引存在且可见"
  - "关键 SQL 执行计划命中新索引"
  - "错误率、P95 延迟和复制延迟未越过阈值"
failure_action: "停止后续变更;必要时执行预先评审过的反向 DDL 或前向修复"
owner: "<ID>"
approver: "<ID>"

预期结果:该模板可按标准 YAML 解析;replication、window 等字段均保持独立层级,发布系统可以分别读取复制风险与执行窗口。

变更单里的“要求”与“观测值”要分开。比如 required_lock: NONE 是发布约束,而长事务数量、表大小、复制延迟是执行前重新采集的事实;如果把二者混在备注里,自动门禁就很难判断是否放行。

用 SQL 固化上线前证据

表规模与长事务应在执行前重新采集,而不是沿用几天前的截图。下面的 SQL 适用于 InnoDB,分别读取目标表估算行数、数据与索引体积,以及当前最长事务持续时间。

sql
SELECT
  table_schema,
  table_name,
  table_rows,
  ROUND((data_length + index_length) / 1024 / 1024 / 1024, 2) AS total_gb
FROM information_schema.tables
WHERE table_schema = 'app'
  AND table_name = 'orders';

SELECT
  COUNT(*) AS active_trx,
  COALESCE(MAX(TIMESTAMPDIFF(SECOND, trx_started, NOW())), 0) AS max_trx_seconds
FROM information_schema.innodb_trx;

预期输出:

text
+--------------+------------+------------+----------+
| table_schema | table_name | table_rows | total_gb |
+--------------+------------+------------+----------+
| app          | orders     | <VALUE>    | <VALUE>  |
+--------------+------------+------------+----------+

+------------+-----------------+
| active_trx | max_trx_seconds |
+------------+-----------------+
| <VALUE>    | <VALUE>         |
+------------+-----------------+

table_rows 对 InnoDB 通常是估算值,因此适合做风险分级,不应当作精确计数。真正决定是否放行的是预先定义的阈值,例如“最长事务必须小于 60 秒”“目标表总大小超过某档位时必须进入低峰窗口”,而不是审批人临时凭感觉判断。

MDL 风险还要结合业务访问模式判断。一个看似在线的 DDL 在开始和结束阶段仍可能需要元数据锁;如果有长事务长期持有相关对象的元数据锁,DDL 可能排队,随后又把新来的查询堵在后面。变更单应明确“发现阻塞链时不执行”,而不是只记录“LOCK=NONE”。

把容量和复制写成停止条件

容量栏不能只填“磁盘充足”。应同时记录当前可用空间、变更可能产生的临时空间预算和报警阈值。涉及表重建、索引构建或在线变更工具时,磁盘峰值可能显著高于最终新增对象大小,因此变更单要引用经过验证的估算方法或演练结果。

复制栏同样要写阈值而不是描述。例如可规定:执行前所有关键副本健康;任一副本延迟超过 30 秒则暂停;变更期间延迟持续上升且超过 120 秒则停止后续批次。阈值应由业务 RPO、读流量和拓扑决定,而不是照抄固定数字。

让验证与失败处置可操作

验证项必须能由执行人或自动化程序给出“通过/不通过”,避免“观察一会儿”“确认业务正常”这类模糊语句。常见的验收证据包括对象定义、关键 SQL 执行计划、应用错误率、延迟、数据库负载和复制延迟。

失败处置要区分“停止”“反向 DDL”和“前向修复”。MySQL DDL 往往会隐式提交,不能把它当成普通事务依赖 ROLLBACK 恢复。删除刚新增的索引可能是可行的反向 DDL,但列类型转换、数据重写或列删除未必能无损恢复,所以必须在上线前写清可逆性、备份点和恢复路径。

一张变更单只有在执行 SQL、风险证据、门禁阈值、验证标准和失败处置都可被第三方复核时,才真正具备治理价值;它的作用是把“经验判断”变成可审计、可自动化的发布契约。

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

目录与阅读设置

记录一个想法

设计 DDL 变更单

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

登录哪都通