迁移数据清单用来把“要迁什么、迁到哪里、怎么对应、谁来负责、如何确认”逐项写清楚，避免执行时靠口头补充。它按“对象—字段—批次—校验”四层组织：先列全数据对象，再细化字段与取值映射，最后挂上批次、责任人和核验标准。下面给出可直接复制到表格工具的三张空白子表，并说明每个字段的填写口径、必填分级、一条完整示例以及后续维护规则。
要点总览（TL;DR）
- 迁移数据清单按“对象—字段—批次—校验”四层组织，用对象编号和批次编号把三张子表串起来，任意一行都能回溯到具体数据对象。
- 对象编号、来源与目标位置、来源与目标标识、映射编号、来源与目标字段、映射方式、批次编号、计划时间窗、校验方式与通过标准属于必填项，缺项会导致定位或判定无法进行。
- 取值转换规则、空值处理、关联对象编号、回退方案、确认人与确认时间属于条件必填，在对应情形出现时必须补齐。
- 字段映射的取值转换要逐项列出原值与新值并写明兜底规则，校验通过标准要写成可量化的条件，避免“基本一致”这类表述。
- 清单需要配套变更记录表，新增对象或字段时追加编号、不覆盖历史行，批次状态由执行人回写、确认人复核。
可复制空白迁移数据清单模板
清单由三张子表组成，通过“对象编号”和“批次编号”两个关联字段串起来。对象表回答“迁什么”，字段映射表回答“怎么对应”，批次校验表回答“什么时候迁、怎么算通过”。三张表可以放在同一个表格文件的不同工作表里，也可以拆成三个协作页面，但关联字段的取值必须一致。
子表一：对象清单
| 对象编号 | 数据对象名称 | 对象类型 | 来源系统/位置 | 来源标识 | 目标系统/位置 | 目标标识 | 记录数 | 数据量 | 关联对象编号 | 负责人 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| OBJ-001 | |||||||||||
| OBJ-002 | |||||||||||
| OBJ-003 |
子表二：字段映射
| 映射编号 | 对象编号 | 来源字段 | 来源字段类型 | 目标字段 | 目标字段类型 | 映射方式 | 取值转换规则 | 默认值/空值处理 | 是否必迁 | 校验规则 | 负责人 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| MAP-001 | |||||||||||
| MAP-002 | |||||||||||
| MAP-003 |
子表三：批次与校验
| 批次编号 | 批次名称 | 包含对象编号 | 计划时间窗 | 执行人 | 校验方式 | 校验通过标准 | 异常处理方式 | 回退方案 | 状态 | 确认人 | 确认时间 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| BAT-001 | |||||||||||
| BAT-002 | |||||||||||
| BAT-003 |
三张表的关联方式是：字段映射表的每一行必须填写一个已存在于对象表中的“对象编号”；批次校验表的“包含对象编号”可以填多个对象编号，用逗号分隔，每个编号同样要能在对象表中找到。这样任意一条映射或批次记录都能回溯到具体对象，不会出现孤立行。
清单字段说明：每个字段记录什么
字段说明的作用是让不同填写人对同一列给出同一种口径。下面按五类字段逐项说明含义、填写口径和示例取值，示例中的取值仅用于说明格式。
对象与位置类字段
| 字段名 | 含义 | 填写口径 | 示例取值 |
|---|---|---|---|
| 对象编号 | 对象的唯一标识 | 按“OBJ-三位序号”统一编号，全表唯一，不随名称修改而变 | OBJ-001 |
| 数据对象名称 | 业务上可识别的对象名 | 使用业务人员熟悉的名称，避免只写数据库表名 | 客户需求单 |
| 对象类型 | 对象的数据形态 | 从主数据、业务单据、附件、配置数据等类型中选择 | 业务单据 |
| 来源系统/位置 | 数据当前所在系统或库表 | 写到系统名加库表或目录层级，便于定位 | 旧需求系统 / req_main |
| 来源标识 | 来源侧的唯一键 | 填写能唯一定位一条记录的字段名 | req_id |
| 目标系统/位置 | 数据迁入的系统或库表 | 与来源位置写法保持一致 | 新需求平台 / requirement |
| 目标标识 | 目标侧的唯一键 | 填写迁移后用于定位记录的字段名 | requirement_id |
| 关联对象编号 | 与本对象有依赖关系的其他对象 | 填写对象表中已存在的编号，多个用逗号分隔；无依赖则填“无” | OBJ-003 |
字段映射类字段
| 字段名 | 含义 | 填写口径 | 示例取值 |
|---|---|---|---|
| 映射编号 | 映射行的唯一标识 | 按“MAP-三位序号”编号，便于在问题记录中引用 | MAP-012 |
| 来源字段 | 来源侧的字段名 | 与来源系统实际字段名一致，区分大小写 | req_status |
| 来源字段类型 | 来源字段的数据类型 | 填写字符串、整数、日期、枚举等 | 枚举 |
| 目标字段 | 目标侧的字段名 | 与目标系统实际字段名一致 | status |
| 目标字段类型 | 目标字段的数据类型 | 与目标系统定义一致，类型不一致时在转换规则中说明 | 枚举 |
| 映射方式 | 字段之间的对应关系 | 填写直接对应、取值转换、拼接、拆分、固定值等 | 取值转换 |
| 取值转换规则 | 来源值到目标值的对应关系 | 逐项列出原值与新值，无法一一对应时写明兜底规则 | 待评审→评审中；已关闭→已完成 |
| 默认值/空值处理 | 来源为空或缺失时的处理 | 写明填默认值、保留为空还是阻断迁移 | 空值填“未分类” |
| 是否必迁 | 该字段是否必须随对象迁移 | 填“是”或“否”，填“否”时在备注说明原因 | 是 |
| 校验规则 | 迁移后如何判断该字段正确 | 写成可执行的判断，如取值落在目标枚举范围内、非空、长度一致 | 取值属于目标枚举集合 |
数量与批次类字段
| 字段名 | 含义 | 填写口径 | 示例取值 |
|---|---|---|---|
| 记录数 | 对象包含的记录条数 | 填写统计时点，数量变化时更新并记录变更 | 12,480 条 |
| 数据量 | 对象占用的存储大小 | 注明单位，含附件时单独列出附件大小 | 约 3.2 GB（含附件 2.1 GB） |
| 批次编号 | 迁移批次的唯一标识 | 按“BAT-三位序号”编号，与批次表一致 | BAT-002 |
| 包含对象编号 | 该批次覆盖的对象 | 填写对象表中已存在的编号，多个用逗号分隔 | OBJ-001, OBJ-002 |
| 计划时间窗 | 批次允许执行的时间段 | 写明起止日期与时段，跨时区时注明时区 | 2025-03-08 22:00 至 03-09 02:00 |
校验与异常类字段
| 字段名 | 含义 | 填写口径 | 示例取值 |
|---|---|---|---|
| 校验方式 | 用什么手段确认迁移结果 | 填写记录数比对、抽样核对、字段取值检查、附件可打开检查等 | 记录数比对 + 5% 抽样核对 |
| 校验通过标准 | 判定通过的具体阈值 | 写成可量化的条件，避免“基本一致”这类表述 | 记录数一致，抽样字段一致率 100% |
| 异常处理方式 | 发现不一致时的处理动作 | 写明记录问题、修正后重迁还是单独补迁 | 登记差异行，修正后随下一批次补迁 |
| 回退方案 | 批次失败时如何恢复 | 写明回退到哪个状态、由谁执行、保留哪些备份 | 保留来源快照，目标侧按批次清除后重迁 |
责任与状态类字段
| 字段名 | 含义 | 填写口径 | 示例取值 |
|---|---|---|---|
| 负责人 | 对该行内容负责的人 | 对象行填数据归属负责人，映射行填字段规则负责人 | 张明 |
| 执行人 | 实际执行该批次的人 | 填写具体人员，不写部门代称 | 李华 |
| 状态 | 批次当前进展 | 从待执行、执行中、待校验、已通过、已回退中选择 | 待校验 |
| 确认人 | 对校验结果签字确认的人 | 与执行人分开，便于形成复核 | 王芳 |
| 确认时间 | 确认动作发生的时间 | 填写日期与时间，状态为“已通过”时必填 | 2025-03-09 10:30 |
必填与选填：哪些字段不能空
必填字段的判断标准是：缺少它，迁移执行或结果确认就无法进行。条件必填字段在特定情形下必须填写，情形不成立时可以留空。选填字段用于补充说明，允许在迁移推进中后补。
| 分级 | 字段 | 理由或触发条件 |
|---|---|---|
| 必填 | 对象编号、数据对象名称、对象类型、来源系统/位置、目标系统/位置、来源标识、目标标识 | 缺少任一项，对象无法被唯一定位，映射和批次也无从挂接 |
| 必填 | 映射编号、对象编号、来源字段、目标字段、映射方式、是否必迁 | 字段对应关系是迁移执行的最小单位，缺项会导致字段被漏迁或错迁 |
| 必填 | 批次编号、包含对象编号、计划时间窗、执行人、校验方式、校验通过标准、状态 | 批次是执行与确认的载体，缺少校验标准就无法判定是否通过 |
| 条件必填 | 取值转换规则 | 映射方式为取值转换、拼接、拆分时必填；直接对应时可留空 |
| 条件必填 | 默认值/空值处理 | 来源字段允许为空，或目标字段要求非空时必填 |
| 条件必填 | 关联对象编号 | 对象之间存在主从、引用关系时必填；独立对象填“无” |
| 条件必填 | 回退方案 | 批次涉及覆盖写入或删除目标数据时必填 |
| 条件必填 | 确认人、确认时间 | 状态进入“已通过”或“已回退”时必填 |
| 选填 | 数据量、记录数 | 用于评估时间窗和资源，可在统计完成后补填，但批次执行前应补齐 |
| 选填 | 来源字段类型、目标字段类型、校验规则（字段级） | 类型不一致或字段有特殊约束时建议填写 |
| 选填 | 备注、负责人（映射行） | 用于补充说明和细化分工，可随迁移推进补充 |
留空的风险集中在两类。一类是定位类字段留空，例如目标标识未填，迁移后无法确认记录落在哪里，校验只能靠人工翻查。另一类是校验类字段留空，例如校验通过标准写成空白或“大致一致”，执行人和确认人对结果的理解不同，容易在切换前反复返工。条件必填字段被忽略时，问题往往在执行阶段才暴露，例如未写空值处理，目标系统因非空约束拒绝写入，整批记录被迫中断。
填写示例：一条需求数据从来源到校验
下面用一条“客户需求单”记录示范三张子表如何联动。示例中的系统名、人名和时间均为演示情景，实际填写时替换为真实信息。
对象行示例
| 对象编号 | 数据对象名称 | 对象类型 | 来源系统/位置 | 来源标识 | 目标系统/位置 | 目标标识 | 记录数 | 数据量 | 关联对象编号 | 负责人 | 备注 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| OBJ-001 | 客户需求单 | 业务单据 | 旧需求系统 / req_main | req_id | 新需求平台 / requirement | requirement_id | 12,480 条 | 约 3.2 GB（含附件 2.1 GB） | OBJ-003 | 张明 | 附件单独成对象，随本对象关联迁移 |
字段映射行示例
| 映射编号 | 对象编号 | 来源字段 | 来源字段类型 | 目标字段 | 目标字段类型 | 映射方式 | 取值转换规则 | 默认值/空值处理 | 是否必迁 | 校验规则 | 负责人 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| MAP-001 | OBJ-001 | req_id | 字符串 | requirement_id | 字符串 | 直接对应 | — | 不允许为空，为空则阻断该行迁移 | 是 | 非空且全表唯一 | 张明 |
| MAP-002 | OBJ-001 | req_status | 枚举 | status | 枚举 | 取值转换 | 待评审→评审中；评审中→评审中；已关闭→已完成；其余值→未分类 | 空值填“未分类” | 是 | 取值属于目标枚举集合 | 李华 |
| MAP-003 | OBJ-001 | create_time | 日期时间 | created_at | 日期时间 | 直接对应 | 统一为同一时区 | 空值阻断迁移 | 是 | 格式符合目标系统日期格式 | 李华 |
批次与校验行示例
| 批次编号 | 批次名称 | 包含对象编号 | 计划时间窗 | 执行人 | 校验方式 | 校验通过标准 | 异常处理方式 | 回退方案 | 状态 | 确认人 | 确认时间 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| BAT-001 | 需求单首批迁移 | OBJ-001, OBJ-003 | 2025-03-08 22:00 至 03-09 02:00 | 李华 | 记录数比对 + 5% 抽样核对 | 记录数一致；抽样记录的 status 与 created_at 一致率 100% | 登记差异行，修正后随 BAT-002 补迁 | 保留来源快照，目标侧按批次清除后重迁 | 待校验 | 王芳 | 2025-03-09 10:30 |
示例与字段说明保持一致：映射行的“对象编号”取自对象行，“取值转换规则”按字段说明中“逐项列出原值与新值”的口径书写，“校验通过标准”写成可量化的条件。批次行引用的两个对象编号都能在对象表中找到，状态与确认时间也符合条件必填规则。
清单的调整与维护方法
迁移范围在准备阶段经常变化，清单需要能追加、拆分和回写状态，同时保留每次变化的原因。维护的重点是让编号稳定、变更可查、状态与执行同步。
清单版本与变更记录
在清单文件开头保留一张变更记录表，每次修改追加一行，不覆盖历史行。表头可以这样设置：
| 版本号 | 变更日期 | 变更人 | 变更类型 | 涉及编号 | 变更内容 | 影响批次 | 审批人 |
|---|---|---|---|---|---|---|---|
| V1.0 | 新增/修改/拆分/作废 | ||||||
| V1.1 |
版本号建议按“主版本.次版本”管理：对象范围或批次划分发生实质变化时升主版本，字段补充、说明修订等局部调整升次版本。变更类型中的“作废”用于对象被移出范围的情形，作废行保留在原位并标注，不直接删除，便于回溯。
新增对象或字段的追加规则
- 新增对象时，在对象表末尾追加新编号，不复用已作废编号；同时补充该对象的字段映射行，并在变更记录中登记。
- 新增字段时，在字段映射表中追加映射行，映射编号顺延；若该字段属于已执行批次的对象，需评估是否单独补迁，并在批次表中新增补迁批次。
- 对象名称或位置发生变化时，保留原编号，修改名称或位置字段，并在变更记录中写明原值和新值。
- 字段映射规则调整时，不覆盖原规则，新增一行并标注生效批次，原行标注停用，避免已执行批次失去依据。
批次调整与状态回写
批次拆分时，原批次编号保留并标注“已拆分”，新批次使用新编号，包含对象编号按拆分结果重新填写。批次执行过程中，执行人将状态从“待执行”改为“执行中”，校验完成后改为“待校验”，确认通过后改为“已通过”并填写确认人和确认时间。出现失败需要回退时，状态改为“已回退”，同时在异常处理方式中记录差异行数量和后续补迁批次编号。状态回写由执行人完成、确认人复核，两者分开可以避免同一人既执行又判定通过。
迁移结束后的归档与复用
全部批次确认通过后，将清单连同变更记录、差异登记和确认记录一起归档，归档版本标注最终版本号和归档日期。归档后的清单可以作为下一次同类迁移的起点：复制一份新文件，保留对象结构和字段映射作为参考，清空记录数、时间窗、状态和确认信息，重新编号批次。这样既复用了已经梳理清楚的字段对应关系，也避免旧状态混入新迁移的执行记录。
当清单需要多人同时维护、按批次分派责任并保留状态流转记录时，可以把对象、映射和批次分别建成工作项或协作文档，用统一编号关联，由负责人更新字段、确认人复核状态。ONES 的工作项字段和文档协作可以承载这类登记与状态回写，让清单从单人表格变成可追溯的协作记录；具体采用表格还是工作项，取决于参与人数和复核要求。
常见问题
迁移数据清单和迁移方案文档是什么关系，能不能只写方案不列清单？
迁移方案文档说明整体策略、时间安排和职责分工，清单则把方案落到每一个数据对象和字段上。只写方案时，执行人仍需自行判断某个字段怎么对应、某批数据何时迁、迁完怎么算通过，这些判断容易因人而异。清单可以看作方案的执行附件：方案确定范围和节奏，清单登记对象、映射和批次校验的具体内容。两者配套使用，方案调整时同步更新清单中的批次和对象范围。
来源系统的字段名在迁移准备期间发生了变更，清单应该怎么处理？
保留原映射行并标注停用，新增一行记录变更后的字段名和生效批次，同时在变更记录中写明原值、新值和变更原因。这样已经执行过的批次仍能对应到当时的字段规则，后续批次使用新规则。如果字段名变化伴随类型或取值变化，还要同步检查取值转换规则和校验规则是否需要调整，避免只改字段名而遗漏下游判断。
附件、图片这类非结构化数据要不要单独列为对象？
建议单独列为对象，并在对象表中通过关联对象编号挂到所属业务单据上。附件通常有独立的存储位置、数据量和校验方式，混在业务单据行里会让记录数和数据量难以核对。单独成对象后，可以在批次表中安排随主对象同批迁移或分批迁移，校验时也能单独检查附件是否可打开、数量是否一致。若附件量很小且与主记录一一对应，也可以在备注中说明合并处理，但要在校验标准中覆盖附件检查。
多个批次并行执行时，清单的状态字段怎么避免混乱？
状态字段按批次行维护，不按对象行维护，每个批次独立记录从待执行到已通过或已回退的进展。对象被多个批次引用时，以批次行的状态为准，对象行只记录归属负责人和基本信息。并行执行时，建议在批次表中增加执行窗口和依赖批次两列，标明批次之间的先后关系；状态回写由各批次执行人负责，确认人复核，变更记录中登记状态变化的时间和操作人。
迁移完成后清单还有复用价值吗，下一次迁移怎么起步？
有复用价值。归档后的清单保留了对象结构、字段映射和取值转换规则，这些内容在同类系统迁移中往往可以沿用。下一次迁移时复制一份新文件，保留对象表和字段映射表作为参考，清空记录数、时间窗、状态和确认信息，重新编号批次并补充新的变更记录。复用时需要重新核对来源与目标系统的字段是否仍然一致，避免直接套用旧映射而忽略系统版本变化。
