数据库 Schema 迁移

目标与适用范围

通过规范化源数据、审阅结构差异、校验关系并准备回滚资产，规划更安全的数据库迁移。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 已准备源 CSV 或 Excel 导出文件。

• 已明确目标数据库的命名和约束规则。

• 已确认迁移范围与可接受停机时间。

• 决策点: 先规范化报表式数据，再设计表结构。. 先规范化报表式数据，再设计表结构。

• 决策点: 外键校验发现孤儿记录时停止执行。. 外键校验发现孤儿记录时停止执行。

• 决策点: 备份和 SQL 审阅完成后才能批准执行。. 备份和 SQL 审阅完成后才能批准执行。

按步骤完成工作流

1. 规范化源记录

把重复列组和宽表整理为稳定记录，并识别需要迁移的业务表。 使用 xlsx-unpivot-normalizer, csv-to-database-migration-planner.

2. 设计并比较目标结构

生成目标表后与现有 schema 对比，找出字段改名、删除和约束变化。 使用 table-schema-generator, database-schema-diff.

3. 校验关系并准备执行

检查 join 与外键，生成并格式化迁移脚本，同时创建执行前备份。 使用 data-foreign-key-validator, multi-table-joiner, database-migration-generator, sql-formatter, database-backup-generator.

交付前验收结果

• 每张源表都有明确的目标映射。
• 结构差异和破坏性变更已经审阅。
• 准备后的数据通过外键校验。
• 执行前已准备格式化 SQL 与备份。

常见问题

• 什么时候必须先规范化源数据？ 当导出文件含重复列组、透视表或报表布局时，应先规范化。
• 为什么生成 SQL 前要比较 schema？ 差异比较会明确破坏性变更和人工审阅范围。
• 自动生成 SQL 后还需要备份吗？ 需要，重复数据或约束生效顺序仍可能导致执行失败。