db-migration-template.md

数据库迁移记录

基本信息

字段	内容
迁移编号	XXXX_YYYYMMDD_description
日期
作者
关联需求/Issue
影响环境	开发 / 测试 / 生产

---

1. 变更概述

变更目的

[为什么需要这个迁移？解决什么问题？]

变更类型

• 新增表
• 修改表结构（加列/改列/删列）
• 新增索引
• 数据迁移（数据转换/清洗）
• 删除表/列
• 其他：___

影响范围

• 影响的表：
• 影响的功能模块：
• 是否涉及数据丢失：是 / 否
• 是否可逆：是 / 否

---

2. 迁移脚本

正向迁移（Up）

-- 描述：
-- 预计执行时间：
-- 预计影响行数：

BEGIN;

-- 迁移语句
-- ...

COMMIT;

回滚脚本（Down）

-- 描述：如何撤销上述变更
-- 注意：数据删除操作不可逆

BEGIN;

-- 回滚语句
-- ...

COMMIT;

---

3. 风险评估

风险	概率	影响	缓解措施
锁表时间过长
数据丢失
应用不兼容

执行前检查

• 已在开发环境测试
• 已在测试环境测试（使用生产数据副本）
• 回滚脚本已验证
• 已通知相关人员
• 已安排低峰期执行
• 已备份相关数据

---

4. 执行计划

执行步骤

1. [备份数据库/相关表]
2. [停止相关服务（如需要）]
3. [执行迁移脚本]
4. [验证数据完整性]
5. [重启服务]
6. [功能验证]

验证查询

-- 验证迁移结果的查询
-- ...

预计停机时间

[是否需要停机？预计多久？]

---

5. 执行记录

步骤	时间	状态	备注
备份		✅/❌
执行迁移		✅/❌
验证		✅/❌
恢复服务		✅/❌

执行结果

• 成功
• 部分成功（说明）：
• 失败已回滚
• 失败未回滚（紧急处理中）

---

6. 后续事项

• 更新数据字典/ER 图
• 更新相关文档
• 通知相关开发人员
• 监控迁移后性能
• 清理临时数据（如有）