对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

使用数据验证

数据验证作为与迁移作业紧密相关的独立进程运行。一次性迁移作业默认运行数据验证。本页详细介绍如何管理和调试数据验证过程。

注意

本页介绍 Relational Migrator 1.18 或更高版本中的验证引擎。早期版本仅检查主键值、验证较窄的模式范围并运行较慢。要使用这些验证功能,请升级到 1.18 或更高版本。

Data Migration 标签页上创建迁移作业时,数据验证默认运行。在 Migration Options 中,Verify migrated data 复选框默认为选中状态。

要跳过验证,请在开始迁移作业之前清除 Verify migrated data 复选框。

注意

数据验证进程可能需要与数据迁移作业一样长的时间,甚至更长。 您可以单击 Terminate 取消数据验证进程。

要查看有关迁移作业的数据验证进程的状态和元数据信息,请单击 Data Verification 下拉菜单:

单击“数据验证”下拉列表
点击放大

Data Verification 窗格中,您可以查看有关迁移作业验证进程的元数据。

语法
说明

验证状态

验证进程的状态。

已启动

数据验证过程开始的日期时间戳。

duration

数据验证过程所花费的总时间。

已验证集合

通过数据验证过程验证的collection总数。

文档已验证

通过数据验证流程验证的文档总数。

验证进度

数据验证过程完成的总工作的实时百分比指标。

数据验证进程可以处于以下任一状态:

状态
说明

中止

由于出现错误,无法完成运行数据验证。

已取消

单击Terminate取消数据验证进程。

取消

正在取消数据验证进程。

已失败

源数据库和目标数据库不匹配。 相应的错误会在Job Update Log窗格中列出。

已验证

数据验证成功,源数据库和目标数据库匹配。

VERIFYING

数据验证正在进行中。 正在运行后端SQL和MongoDB查询API命令以验证迁移。

迁移作业成功后,状态会更新为 Verified,并在 History 窗格中显示双复选标记:

历史记录窗格双复选标记
点击放大

如果数据验证过程检测到源数据库和目标集合之间存在任何差异,则会在“数据验证” Job Update Log 窗格中报告错误。验证引擎会报告具体错误,包括字段名称不匹配、数据类型、字段路径(Field Path)和值。验证引擎还会报告缺少或意外的目标文档以及跳过的集合或字段。

在此示例中,验证引擎在 orders 集合中检测到源行与目标文档之间的一个不匹配字段:

  1. 事件概要显示不匹配类型、受影响的集合以及受影响文档的主键值。

  2. Event details 部分列出了验证引擎找到的每个字段差异。

显示字段不匹配错误的作业更新日志条目
点击放大