迁移完整性校验需要哪些依据:对象、字段与证据清单

迁移完整性校验的依据由四类材料构成:迁移范围基线、字段与关系映射表、逐对象的数量与内容比对结果、差异处置台账。四类依据按顺序产出,后一类依赖前一类;所有比对都以迁移前冻结的基线为唯一口径,差异逐条登记并判定为通过、可接受或阻断,同时保留可执行的回退点。



要点总览(TL;DR)


  • 完整性校验的依据由四类材料构成:迁移范围基线、字段与关系映射表、逐对象比对结果、差异处置台账,按顺序产出、逐层依赖。
  • 范围基线要写清源系统与目标系统的名称和版本、对象类型清单、数量快照与取数时点,冻结后变更必须登记并更新版本号。
  • 映射表除字段对应关系外,还要给出转换规则、可空与默认值处理、值域映射、关系映射和核验方式,作为差异判定的标准。
  • 比对先做数量再做内容抽样,抽样规则事先约定并保留样本清单;差异按阻断、可接受、待确认三级判定,修复后必须复验。
  • 校验通过需阻断性差异为零、数量差额为零或有批准说明、抽样一致率达标,并完成签字归档;回退点要在切换前准备好。


校验依据的四个来源:范围基线、映射表、比对结果与差异台账


完整性校验要回答的问题是“迁移后是否与迁移前一致”。这个问题不能靠感觉判断,需要一组可追溯的材料支撑。四类依据分别解决“比什么”“按什么口径比”“比出了什么”“差异怎么处理”,缺任何一类,结论都无法复核。


范围基线确定比对的对象边界。它记录源系统、目标系统、版本、对象类型与数量,是后续所有计数的分母。基线未冻结就开始迁移,源端数据仍在变化,数量对不上时无法区分是迁移丢失还是源端新增。


映射表确定字段级和关系级的比对口径。同一个字段在源端与目标端可能名称不同、取值域不同、必填规则不同,映射表把这些转换规则写清楚,比对时才能判断“目标端的这个值是正确转换还是错误丢失”。


比对结果是执行层产出。按对象类型统计记录数、附件数、评论数,再对内容做抽样核验,形成可逐条核对的记录。比对结果只陈述事实,不直接下结论。


差异台账承接比对结果中的不一致项。每条差异登记位置、类型、影响范围、判定结论和处置动作,是校验结论的直接证据。四类依据的依赖关系是:基线定义范围,映射表定义口径,比对按口径在范围内执行,差异台账对执行结果定性。


依据类型 核心内容 产出时点 责任人
范围基线 源/目标系统与版本、对象类型清单、数量快照 迁移执行前,冻结后不再改动 迁移负责人,业务方确认
字段与关系映射表 字段来源与目标、转换规则、值域映射、关系映射 映射设计完成后、试迁移前 数据映射设计人,业务方评审
比对结果 分对象类型的数量比对、抽样内容核验记录 试迁移后与正式迁移后各一轮 校验执行人
差异台账 差异位置、类型、分级、处置与复验结论 比对完成后持续更新至关闭 校验负责人,业务方判定可接受性


迁移范围基线怎么定:源、目标、版本与对象清单


范围基线是校验的起点,作用是把“迁移了什么”变成一份可核对的清单。基线不清,后续数量比对就没有分母,抽样也无从分层。


基线需要记录源系统与目标系统的名称和版本。版本信息影响字段可用性和行为差异,例如源端某类工作项带有目标端当前版本不存在的属性,这类情况要在基线阶段登记,而不是等到比对时才发现。版本记录以迁移实施时实际使用的版本为准。


对象类型清单要覆盖实际迁移的全部数据类别,常见包括工作项、需求、缺陷、文档、附件、评论、关联关系,以及人员、状态、枚举等基础数据。每类对象标注是否迁移、迁移范围(全量或按项目、时间范围筛选)、预计数量。只迁一部分的对象类型必须写明筛选条件,否则数量比对会出现无法解释的差额。


数量基线的取数时点要明确到具体时间,并在取数后立即冻结源端写入或记录冻结时刻。推荐做法是:在计划停机或源系统转只读的时刻取数,取数结果作为基线数量;如果无法停机,则记录取数时间戳,并约定该时间点之后的新增数据不计入本次校验范围。


范围变更必须登记。迁移过程中如果业务方要求追加一个项目或一类对象,要在变更记录中写明变更内容、批准人、对基线数量的影响,并更新基线版本号。口头追加、临时补迁而不登记,是校验阶段数量对不上最常见的原因。


基线字段 填写要求
源系统 / 目标系统 产品名称与版本号
对象类型 逐类列出,标注迁移范围与筛选条件
基线数量 每类对象的记录数、附件数、评论数
取数时点 精确到日期与时刻,注明源端是否已只读
冻结确认 迁移负责人与业务方签字或审批记录
变更记录 变更内容、批准人、基线版本号


字段与关系映射表要提供哪些校验信息


映射表在校验中的角色是“判定标准”。比对时看到目标端某个字段为空或值不同,需要靠映射表判断这是规则允许的结果还是迁移错误。因此映射表不能只写“A字段对应B字段”,还要写清转换逻辑和预期结果。


字段级信息至少包含:源字段名、目标字段名、数据类型、转换规则、必填与可空约定、默认值处理。转换规则要具体到可执行,例如“源端优先级取值P0–P3,目标端映射为紧急、高、中、低”,而不是笼统写“按规则转换”。可空性决定比对时是否把空值视为差异:源端允许为空、目标端必填时,映射表要说明填充默认值的规则,比对时按规则核对默认值是否正确写入。


值域映射要单独列出状态、枚举、人员、组织等字段的对照关系。状态映射尤其容易出问题,源端的自定义状态在目标端可能没有一一对应的选项,映射表要写明归并规则,并标注哪些状态属于有损转换、需要业务方确认可接受。


关系映射覆盖父子工作项、关联关系、附件归属、评论所属对象等。每条关系映射要说明源端关系类型、目标端关系类型、是否双向、迁移后如何验证。附件和评论要记录其挂载对象的对应关系,避免出现“附件数量对得上但挂错对象”的情况。


映射表还要有一列“核验方式”,说明该字段用全量比对还是抽样比对、比对工具或脚本、预期一致率。这一列把映射表与比对执行直接连起来,差异判定时也能快速定位适用规则。


映射表列 说明 示例
源字段 / 目标字段 名称与数据类型 status → status
转换规则 可执行的转换逻辑 自定义状态归并为目标端标准状态
可空与默认值 空值处理约定 源端为空时写入“未设置”
值域映射 枚举、人员、组织对照 P0→紧急,P1→高
关系映射 父子、关联、附件、评论归属 子任务→子工作项,双向关联保留
核验方式 全量或抽样、比对口径 全量比对,允许归并类差异


数量比对与内容抽样:校验怎么做、记录什么


数量比对先做,内容抽样后做。数量对不上时先解决数量问题,否则抽样核验的对象集合本身就不完整。


数量比对按对象类型逐类进行,用基线数量与目标端实际数量对照。工作项、需求、缺陷按记录数比对;附件按文件数比对,同时核对附件总大小是否在合理范围;评论按条数比对;关联关系按关系条数比对。每类对象记录基线数、目标数、差额、差额原因。差额为零不等于内容正确,只说明数量层面通过。


抽样规则要事先约定并写入校验方案。常用做法是按对象类型分层抽样:数量大的类型按固定比例抽取,关键业务对象(如高优先级需求、近期活跃缺陷)提高抽样比例或全量核验,边界情况(空描述、超长文本、特殊字符、多附件)单独列入必查样本。抽样样本要记录抽取规则和样本清单,便于复核时重现。


内容一致性检查项包括:标题与描述文本是否一致、状态与优先级是否符合映射规则、创建与更新时间是否保留、创建人与处理人是否正确对应、附件能否打开且内容一致、评论是否挂在正确对象下、父子与关联关系是否完整。文本类字段比对时注意空白字符、换行和富文本格式的差异,这类差异要在映射表中预先约定是否可接受。


比对结果用固定格式记录,每行一条核验项,包含对象类型、核验项、核验方式、样本量、一致数、差异数、差异编号。差异编号与差异台账一一对应,避免两套记录对不上。


记录表 关键列
数量比对表 对象类型、基线数、目标数、差额、原因说明、核验人、核验时间
抽样核验记录表 样本编号、对象标识、核验项、源端值、目标端值、是否一致、差异编号


差异如何判定与处置:通过、可接受与阻断


差异分级要在比对开始前定好,不能等看到差异再讨论是否严重。建议按影响分为三级:阻断性差异、可接受差异、待确认差异。


阻断性差异指影响业务可用或数据正确性的问题,例如记录丢失、关键字段为空或错误、附件缺失或损坏、关联关系断裂、权限归属错误导致数据不可见。出现阻断性差异时,校验结论为不通过,必须修复后复验。


可接受差异指由映射规则明确允许的转换结果,例如自定义状态归并、富文本格式简化、系统字段重新生成。可接受差异仍需逐条登记,写明依据的映射规则条款和业务方确认记录,不能以“已知问题”一笔带过。


待确认差异指当前规则未覆盖、需要业务方判断的项。这类差异要有明确的确认人和确认时限,超时未确认的按阻断处理,避免校验结论悬空。


差异修复后必须复验,复验范围至少覆盖原差异项及其关联对象,复验结果回写台账并记录复验人和时间。差异台账的字段包括:差异编号、对象类型与标识、差异描述、源端值、目标端值、分级、判定依据、处置动作、责任人、状态、复验结论。


差异台账和比对记录是切换评审的直接输入。在ONES中,可以把差异项登记为工作项、把校验方案与比对记录沉淀为项目文档,让每条差异的判定、处置和复验在同一个工作项上留痕,评审时按状态筛选即可看到未关闭项,减少在多份表格之间核对的工作量。



校验通过标准与切换前的回退点


校验通过需要同时满足量化条件和程序条件。量化条件建议写成:阻断性差异为零;可接受差异全部有映射规则依据和业务方确认;待确认差异全部关闭;各对象类型数量差额为零,或有经批准的书面说明;抽样一致率达到方案约定值。程序条件是校验报告完成签字,比对记录、差异台账、复验记录归档到同一位置。


回退点要在切换前准备好,而不是等出问题再想。前置准备包括:源系统在切换窗口内保持只读或可恢复写入、完成源端数据备份并验证可恢复、明确切换窗口时长和决策人、准备回退操作步骤和预计耗时。回退触发条件例如:阻断性差异在窗口内无法修复、关键对象类型数量差额超出约定阈值、目标端出现影响业务连续性的故障。


停止迁移的判断情形包括:基线在迁移过程中被反复变更且未登记、源端数据质量导致大量对象无法映射、差异修复后复验仍出现同类问题。这些情形下继续推进只会扩大返工范围,应暂停并重新评估范围与映射方案。


判定项 通过条件 不通过时的动作
阻断性差异 数量为零 修复后复验,未修复则触发回退评估
可接受差异 全部登记且有规则依据与确认记录 补充确认或升级为阻断
数量比对 差额为零或有批准说明 定位差额原因,补齐或修正基线
抽样一致率 达到方案约定值 扩大抽样,确认是否为系统性问题
证据归档 报告签字,记录齐全可追溯 补齐后重新评审


常见问题


源系统无法停机取数,数量基线怎么定才不影响校验结论?


无法停机时,取数结果要带精确到时刻的时间戳,并在校验方案中约定该时间点之后源端新增或修改的数据不计入本次校验范围。比对时目标端数量与基线数量的差额,需要能对应到冻结时刻之前的数据。如果迁移窗口较长、源端持续写入,建议在正式迁移前安排一次短时只读窗口重新取数,用这次取数结果替换早期基线,避免差额原因无法区分是迁移丢失还是源端新增。


映射表里标注为有损转换的字段,校验时应该怎么处理?


有损转换字段在比对时按映射表写明的归并规则核对,而不是要求源端值与目标端值逐字相同。例如多个自定义状态归并为目标端一个标准状态,只要目标值落在规则允许的集合内即视为一致。这类差异登记为可接受差异,写明依据的映射规则条款和业务方确认记录。如果归并后丢失了业务判断所需的信息,应在映射设计阶段就提出,校验阶段只能确认规则是否被正确执行,无法弥补规则本身的缺陷。


抽样核验发现个别对象内容不一致,是否必须整体判定不通过?


取决于差异的性质和分布。单条差异先按分级规则判定:属于记录丢失、关键字段错误、附件损坏、关联断裂的,按阻断处理,修复后复验该对象及其关联对象。属于格式简化、空白字符差异等映射规则允许范围的,登记为可接受差异。如果同类差异在抽样中反复出现,说明可能是系统性问题,应扩大抽样范围确认影响面,再决定是否整体判定不通过,而不是逐条修补了事。


差异修复后复验,范围要覆盖多大?


复验范围至少覆盖原差异项本身及其关联对象。例如修复一条工作项的附件归属,要同时确认该工作项下其他附件和评论的挂载关系;修复一条关联关系,要确认关系两端的对象都存在且可见。复验结果回写差异台账,记录复验人、复验时间和结论。如果同类差异批量修复,建议按修复批次做一次针对性抽样,确认修复动作没有引入新的不一致。


切换窗口内发现阻断性差异,回退前需要确认哪些条件?


回退前要确认源系统在窗口内仍保持只读或可恢复写入、源端备份已完成并验证可恢复、回退操作步骤和预计耗时已明确、决策人可即时拍板。回退触发条件应在切换前写入方案,例如阻断性差异在窗口内无法修复、关键对象类型数量差额超出约定阈值、目标端出现影响业务连续性的故障。触发后按预案执行,不在窗口内临时讨论是否继续。