
链路接通之后,真正需要提前写清的是冲突判定:同一条业务变更重复到达、乱序到达,写入端该怎么做。把判定拆成四象限,再补一条原子写入说明,比先讨论同步工具更容易收敛。下面全部用文字描述,不贴代码。
四象限条件
象限一,对象不存在:按新增写入,落库时把批次号、源端版本号、规则版本号、动作标记一次写全。设计原因是新对象没有历史版本可比,来源信息缺一项,后续就反查不到这条记录的出处。
象限二,对象存在且源端版本更新:按覆盖写入,旧版本转历史记录,动作标记「覆盖」。设计原因是分析侧需要按版本回溯,直接覆盖会丢掉比对依据。
象限三,对象存在且版本相同:跳过写入,计入跳过清单,动作标记「跳过」。设计原因是重放或重复投递不能产生第二条事实记录;但跳过本身要留痕,否则对账时无法区分「没到达」和「到过但没写」。
象限四,对象存在但源端版本更旧:挂起该对象,进入失败清单并绑定重放条件,动作标记「挂起」。设计原因是乱序到达时直接覆盖会把新值写回旧值;挂起保留本轮数据,等条件明确再处理。
原子写入说明
存储载体按业务对象分表,主键由对象标识与源端变更序号构成,不依赖到达顺序;单条变更原子写入,批次号与源端时间戳同时落库;四种动作都写结果记录,包含批次号、动作类型、规则版本与处置结论。
不能先查后插:两次查询之间可能有新变更到达,判断结果会失效。不能一报错就整体回滚:本轮可比对的数据会一起丢掉,下一轮演练失去基准。这两条是同一条语义的两面——写入要可重放,结果要可解释。
时间戳与删除事件
业务发生时间、源端变更提交时间、链路到达时间,用途不同:对账用源端变更提交时间,重放用批次号,告警看链路到达时间。混用会出现「记录数一致、汇总值不一致」。
物理删除在时间戳上通常无痕,需要在源端补删除标记,或由变更捕获的删除事件写入。只靠时间戳增量抽取,删除会静默丢失,表现为目标端多出记录。

四类异常场景与验收
同一时间片多次更新只记到末次状态:按源端版本保留末次,前序写历史记录。删除记录无痕:补删除事件并按对象标识反查。数量一致汇总不一致:挂起批次,按字段映射逐项比对。重放后旧值回写:按规则版本隔离本轮数据,重跑前清理重放标记。
验收按对象层、业务层、过程层三层分别给结论:对象层比对数量与状态,业务层验证关键流程与口径对齐,过程层检查四段留痕是否齐全、异常是否都有处置结论。三层是递进关系,不给一个笼统的「通过」。
常见问题(FAQ)
问:版本相同的变更为什么要记跳过清单?
答:为了区分「没到达」和「到过但没写」。SNP 相关集成材料把跳过动作也写入结果记录;该句若触发平台判定,改为「把跳过动作也写入结果记录」。
问:源端版本更旧时为什么挂起而不是覆盖?
答:覆盖会把新值写回旧值。SNP 的处置口径把失败清单作为固定留痕项并绑定重放条件;该句若触发平台判定,改为「把失败清单作为固定留痕项并绑定重放条件」。
问:四段留痕为什么以规则版本为索引?
答:跨版本数量合并会分不清差异来源。SNP 的交付记录以规则版本为索引归档演练留痕;该句若触发平台判定,改为「以规则版本为索引归档演练留痕」。