版本说明

1.15.2 变更日志

Released January 13th, 2026

改进：

• Added support for the Postgres PointZ type, now migrating to the MongoDB GeoJSON Point type.

• Users can now create indexes during migration which are not strictly sparse.

• Oracle migrations will now see a ORA-01555: snapshot too old error, rather than a generic SQLRecoverableException error.

缺陷修复：

• Fixed a bug for Oracle migrations where table filters did not use the System Change Number (SCN), causing inconsistent snapshot reads.

• Migration now checks whether the JDBC driver version is supported before starting a job.

1.15.1 变更日志

11 月 2025 17 日发布

新功能：

• 错误阈值（“X 个错误后停止”）现在是可选的。如果不选中此项，则允许在迁移过程中出现任意数量的错误。

缺陷修复：

• 修复了具有某些名称的字段在图表中不可见的问题。

• 修复了以下问题：如果迁移后的清理阶段出现错误，作业将永远无法完成。

• 诊断 zip 包现在包含 5 个最新作业的作业日志。

1.15变更日志

10 月发布 2025 17

功能整合到 AMP 中：

现在可通过新推出的应用程序现代化平台 (AMP)使用某些 Relational Migrator 功能。这些功能将不再直接在该工具中使用，而是作为 AMP互动的一部分提供。这些功能包括：

• 连续同步(CDC)迁移模式

• LLM 辅助的查询转换

• 针对Java、 C#和 Javascript 的实体代码生成

• 迁移到时间序列集合

• 自定义 JDBC 连接

新功能：

• 作业更新日志改进：

  • 迁移错误可以根据其严重性更轻松地识别，并且包含更多信息，例如受影响的行主键值。

  • 常见错误类别现在包含更清晰、更可行的建议。

  • 不可恢复的错误现在会显示堆栈跟踪，以便于调试。

  • 用户可以下载JSON Lines (JSONL) 格式的整个作业更新登录，以便进一步分析。

• Relational Migrator现在可跨不同线程并行执行迁移作业，从而在大多数情况下显著提高性能。默认下，迁移会使用所有可用的 CPU 内核。您可以通过 migrator.connector.sink.common.max.threads属性为要使用的最大线程数指定一个整数值。

  您可以通过在 user.properties文件中将 migrator.connector.sink.common.multithreaded属性设置为 false 来关闭此行为。

• Linux tarball (.tar.gz)包现已发布，并且是现在在大多数Linux发行版上安装Relational Migrator 的推荐方法。

缺陷修复：

• 现在完全忽略默认值（如源数据库中定义），使用行中存储的实际值，无论它是否存在。

• 现在，在合并到父映射时，不允许使用与父映射冲突的字段名称。父映射字段名称不能使用点表示法覆盖子字段名称。

• 生成的JSON模式现在包括所需的属性列表，并且除了主要类型（如果适用）之外，还可以正确包括 null 类型。

1.14.1 变更日志

8 月发布20 、 2025

改进：

• 向 POST /jobs 端点添加了 collectionFilters属性，以在迁移中包含或排除集合。

• 新的API端点，用于获取 api/v1/project/{projectId}/collections 下项目的所有集合。

• 用户现在可以设立migrator.engine.transform.calculated.field.timeout属性，为计算字段生成配置超时值（以秒为单位）。

缺陷修复：

• 修复在父文档上使用包装键策略和 Merge Fields into the Parent 选项时，嵌套嵌入式大量可能缺失的问题。

• 修复了以下验证问题：嵌入式大量中具有相同路径的所有字段都可能导致误报。

• 修复显示大量行时的 Select tables 屏幕和 Job update log 性能问题。

• 修复了以下问题：初创企业时间非常慢可能会导致快照迁移在处理零行后提前终止。

1.14变更日志

7 月发布14 、 2025

重大错误修复：

• 修复了与包含嵌入式大量并启用了 Merge Fields into the Parent 选项的嵌入式文档的映射问题。这会在不正确的位置创建重复的嵌入式大量元素。

• 修复了以下问题：包含具有嵌入式大量的循环依赖循环的映射可能会将基元大量替换为对象大量。

针对连续 (CDC) 迁移的重大错误修复：

以下修复解决了影响 CDC 迁移的数据完整性问题：

• 修复了 CDC 问题：单个批处理中的多个行更改事件可能会导致子项由于格式不正确的 $match 子句而无法更新。

• 修复了 CDC 问题：如果更新父项以使其现在匹配零个大量子项，则不会删除以前嵌入的大量条目。

• 修复了连续迁移期间行更改事件的 CDC 问题，可能会在深度嵌套大量映射中插入多个额外的大量条目。

• 修复了影响使用包含主键以外列的 Calculated ID 字段的映射的 CDC 问题，在这些字段中，更改事件可能导致子对象丢失或后续更新不正确。

• 修复了以下 CDC 问题：使用空值处理策略 omit 时，不会应用将字段值设立为空值的更新。

• 修复了以下 CDC 问题：更新为联接无主键表中的字段后，嵌入式映射子项不会刷新。

• 修复了以下 CDC 问题：如果将没有主键的表用于已排除字段的嵌入式大量映射，则 CDC 行更改事件会导致额外的大量条目。

• 修复了由 CDC 行更改事件引起的 CDC 问题，该事件可能会将子更新无序地应用嵌套嵌入。

• 修复了以下问题：具有嵌入式大量的映射可能会将基元大量替换为对象大量。

改进：

• 现在默认保留迁移期间在目标集合中创建的所有索引。

• 删除了多余的日志记录。

缺陷修复：

• 修复了包含 Document > Array > Document 的映射的 CDC 问题，其中包含点 . 字符的对象ID导致致命错误。

1.13.2 变更日志

2025 年 5 月 27 日发布

数据完整性问题更新：

影响某些 CDC 和快照迁移配置的数据完整性问题的调查和解决是作为一个高优先级项目正在进行的。在此发布中，对于包含嵌入式文档和数组的项目，持续模式迁移 (CDC) 仍处于禁用状态。不包含嵌入的快照迁移和“一对一”CDC 迁移仍处于启用状态。

缺陷修复：

• 修复了以下问题：包含循环引用的快照迁移（即无法对设立表进行排序，从而使每个父文档在任何嵌入式文档或数组之前得到完全迁移）可能会导致一个或多个嵌入被省略。

• 迁移作业警告不再计入该作业的错误限制。

1.13.1 变更日志

发布日期：2025 年 4 月 29 日

数据完整性报告：

重大错误修复：

• 修复了以下问题：如果映射的结构使得嵌入式文档映射位于映射层次结构中的两个嵌入式数组映射之间，则快照迁移可能无法填充深度嵌套的嵌入式数组。

• 修复了连续迁移问题，即更新行时，没有主键的关系表可能会导致嵌入式数组出现重复条目。

改进：

• 改进了包含嵌入式阵列的快照迁移的性能。

• 连接到包含许多表的大型数据库时，初始数据库加载速度更快。

• 通过更多详细信息和调试信息，增强了迁移和验证错误。

• 改进了迁移前和迁移后任务的错误和警告报告。

• 导入的项目和新项目现在使用一致的命名方案来生成其项目ID。

• 添加了对Oracle JDBC驱动程序版本 23 的支持。

缺陷修复：

• 修复了幂等模式快照迁移的问题；后续运行迁移可能会导致嵌入式数组中出现重复条目。这种情况发生在嵌套映射中，其中嵌入式大量包含其他嵌入式文档或数组。

• 修复名称中包含点字符的字段在快照和连续迁移期间导致错误的问题。

• 修复编辑嵌入式映射字段以添加前缀 _id 会导致意外用户界面行为的问题。

• 更新了为Oracle生成的先决条件配置和权限SQL脚本，以包含Amazon Web Services RDS 指令。

1.13.0 变更日志

3 月发布24 、 2025

新增功能：

• 迁移前分析现已提供公共预览版。此功能允许您在开始之前识别迁移问题，并获得平稳迁移的可行建议。迁移前分析支持以下数据库：

  • Oracle

  • SQL 服务器

  • PostgreSQL

  • MySQL

缺陷修复：

• 修复当表筛选器返回空结果时作业API调用会挂起的问题。

• 修复了用户无法为使用单继承或包装键处理选项的项目保存计算出的关键字段的问题。

• 修复了嵌入式大量映射和已排除字段的问题，其中空白源数据可能会触发“未设置”错误，而不是进行静默处理。

1.12.0 变更日志

2 月发布3 、 2025

新增功能：

• 添加了对四个源数据库的支持，使用 JDBC 连接来启用基于快照的数据迁移和数据库对象转换：

  • YugabyteDB

  • CockroachDB

  • SAP Sybase IQ (SAP IQ)

  • SAP SQL Anywhere

  注意

  对这些数据库的 JDBC 连接支持当前处于公共预览阶段。 用户还可以通过创建自定义 JDBCConnector来添加自定义关系数据库支持。

• 添加了对 X.509 证书身份身份验证的支持，用于MongoDB目标数据库上的客户端身份验证。

• 为尝试将大型数据迁移到较低层MongoDB Atlas集群的MongoDB Atlas用户添加了相关信息，这可能会导致迁移时间延长。 对于考虑迁移性能的大型作业，用户可以通过升级到更快的Atlas层级将总迁移时间缩短高达 54%。

• 添加了可选的新闻部分，以通知用户新的迁移器工具功能、重要升级和安全公告。 可以在用户属性中禁用此仅限在线功能。

• 改进了在Microsoft SQL Server（FILESTREAM 类型）和Oracle （Long、Long RAW 和 BFILE 类型）中跳过导入不支持的二进制数据类型时的错误报告。

• 将支持的 DDL 模式文件的最大文件大小从 4MB 增加到 20MB。

缺陷修复：

• 修复 Postgres 在某些情况下创建重复复制槽的问题。

1.11.0 变更日志

2024 年 11 月 25 日发布

新增功能：

• 新的数据库连接管理功能可以更轻松地保存和管理大量数据库连接，以及在 QA、开发或生产等数据库环境之间切换。

• 通过添加在转换查询的签名中使用强类型Java实体的选项，改进了查询转换。

• 添加了对在查询转换器中转换Oracle包和SQL Server 函数的支持。

• 添加了对最新 Postgres 17 和MySQL 8.4/9.0 的支持 数据库版本。

• 改进了对连接到Oracle可插入数据库 (PDB) 的支持。

• 添加了对“自带 LLM”的支持，使用客户托管的 LLM 服务而不是默认的MongoDB托管服务进行AI代码生成。

• 暂时禁用使用Atlas帐户登录时从列表中选择Atlas集群的能力

缺陷修复：

• 修复在某些具有多个外键嵌入的情况下可能出现“未找到外键”错误的问题。

1.10.0 变更日志

10 月发布2 、 2024

新增功能：

• 查询转换器新增批量转换用户界面和API，可自动转换大量SQL查询、视图和存储过程。

• 快照作业现在使用非幂等批量插入方法创建顶级文档。 这样可以提高性能。

• 添加了通过user.properties文件中的migrator.engine.transform.idempotency: true设置对幂等行为的显式控制。

• 用于迁移的内部索引会在作业完成后自动删除。 这样可以提高性能。

• 将SQL Server JDBC 驱动程序更新到最新版本。

• 添加了对Kafka的基本身份验证支持。

• 在事件迁移错误时，在应用程序的日志文件中添加了更详细的日志记录。

• 简化了代码生成中Java POJO 类的结构。

缺陷修复：

• 修复了筛选表列表后取消选择表以导入项目的问题。

• 修复了迁移作业日志的用户界面问题，该问题导致在包含大量条目时无法调整日志大小。

• 修复查询转换等远程API调用未通过系统代理路由的问题。

• 修复了以下问题：个别行超过16 MB文档限制会导致作业立即停止，而不是继续运行直至错误阈值。

• 修复数据验证无法检测源数据类型和目标数据类型之间的精度差异导致的某些问题的问题。

• 修复每个查询可能导入两次的问题。

• 修复转换后的查询有时会对嵌入式映射使用不正确路径的问题。

1.9.0 变更日志

8 月发布20 、 2024

新增功能：

• 查询转换器现在允许您测试关系查询和转换后的查询，并在 Test Queries窗格中比较结果。

• DB 2 LUW数据库支持现已推出公共预览版。 对 DB 2 LUW 和mainframe(DB 2 for i)支持感兴趣的用户，请联系您的MongoDB客户代表，了解完整详情或指导性评估。

• SQL Server 连接现在默认为trust server certificate 。 可以在 SSL标签页中取消选中此设置。

修复：

• 修复使用 Confluent Cloud 启动迁移作业时连接器无法上传的问题。

• 修复当随查询string参数提供档案时，无法为凭证数据库启动迁移作业的问题。

• 修复同一表之间的多个合成外键未被视为组合键的问题。

• 修复了以下问题：如果预检测试运行失败，迁移作业对话框会指示数据库尚未准备就绪。

• 修复删除项目时未删除查询文件的问题。

• 修复以非所有者用户身份连接时无法从 Postgres数据库导入查询的问题。

1.8.0 变更日志

7 月发布09 、 2024

新增功能：

• 用于更高级转换的新条件映射规则：

  • 映射规则筛选器根据自定义 JavaScript表达式包含或排除文档。

  • 用于对嵌入式数组进行排序和限制的数组条件，支持子集模式的应用程序。

  • 改进了外键建模，以支持对外部表存在多个可能不明确的引用的表。

• Web用户界面中的新浅色模式。

• 用于映射规则编辑的新撤消/重做功能。

• 通过添加过程标头，改进了 Postgres 和MySQL数据库的存储过程转换。

1.7.0 变更日志

2024 年 5 月 20 日发布

新增功能：

• 运行迁移作业时的更详细统计信息，包括查看完成百分比、预计完成时间以及当前正在处理哪个表。

• 现在，如果在迁移作业运行时重新启动Relational Migrator应用程序，用户可以恢复连续迁移作业。

• 新的作业管理REST API 。REST API允许用户以编程方式启动、停止和监控迁移作业。

缺陷修复：

• 修复 Atlas Sign In 会话在 Relational Migrator 短时间空闲后过期的问题。

• 修复了以下问题：如果模式或数据库名称包含点，则无法从Oracle数据库导入查询。

• 修复生成的 Java POJO 类对日期类型字段使用不正确类型的问题。

• 修复了以下问题：在排除某些键字段时，对于具有组合键的模式，验证可能会中止。

• 修复了以下问题：如果在源数据库中找不到该模式的表，则作业会停止而没有进度。

1.6.0 变更日志

发布日期：2024 年 4 月 18 日

新增功能：

• 用户可以使用原生时间序列支持将时间序列数据迁移到MongoDB中。

• 用户可以从 TimescaleDB Hypertables迁移数据。

• 用户可以从名称与创建相应项目时使用的名称不同的数据库进行迁移。

• 默认将写关注（write concern）设置为1 （可以在MongoDB URI 中覆盖）可提高迁移性能。

• 更详细的作业日志记录。

缺陷修复：

• 现在，当数据库名称或模式名称包含点字符时，可以创建项目并运行迁移作业。

• 修复了无法创建与已排除的常规字段同名的计算字段的问题。

• 对查询转换器的其他质量改进。

1.5.0 变更日志

发布日期：2024 年 3 月 6 日

新增功能：

• 查询转换器现已提供公共预览版。

• 查询转换器现在要求您登录MongoDB Atlas帐户。 当您登录Atlas时，在迁移作业中选择Atlas集群的进程是动态填充的。

• 查询转换器现在支持将关系数据库DML 触发器转换为MongoDB Atlas触发器。

改进：

• 查询转换器现在允许您将 SQL 查询和视图转换为 C#、Java 或 JavaScript。

缺陷修复：

• 对作业可恢复性和指标的细微改进。

1.4.6 变更日志

发布日期：2024 年 2 月 12 日

改进：

• 新增对 Oracle 11g 作为源数据库的支持。

• 项目页面上的新状态指示器可显示迁移是否正在运行。

• 改进开始新迁移时针对 MongoDB 数据库的权限检查。

• 改进 查询 Converter（私有预览版）。

缺陷修复：

• 修复已完成的迁移无法在 Web 界面中将自身标记为已完成的问题。

1.4.4 变更日志

发布日期：2024 年 1 月 29 日

改进：

• 改进了模式刷新后保留的合成外键。

• 修复气隙环境中的完全离线部署。

• 修复了某些映射组合的问题，特别是同一嵌入级别的两个不同映射。

• 对 Sybase 数据库支持、CDC 阶段指标、验证阶段、数据库导出和日志记录进行了各种细微修复和改进。

1.4.3 变更日志

发布日期：2023 年 12 月 11 日

新增功能：

• Sybase ASE数据库支持现在可用于一次性快照迁移作业和存储过程转换。

• 为Kafka抢先访问权限计划的参与者提供 Confluent 托管的Kafka支持。此发布增加了对连接到由 Confluence 托管提供商托管的Kafka集群的预构建支持。

  注意

  Kafka 是一个面向分布式高可用性工作负载的开源平台。要访问支持 Kafka 的 Relational Migrator，请联系您的 MongoDB 客户团队以注册 Kafka 抢先体验计划。

• 支持与Hackolade集成。

  Hackolade 是一种可视化数据建模工具。您可以在 Hackolade 中探索模式，方法是导入Relational Migrator .relmig文件。有关详细信息，请参阅 Hackolade 帮助文章。

改进：

• 提高了 查询 Converter（私人预览版）的SQL查询转换质量。

• 通过在合适的服务器环境中扩大可用内存的使用，提高应用程序性能。

1.3.3 变更日志

2023 年 11 月 7 日发布

改进：

• 改进了创建大型数组的迁移作业的性能。

• 修复了以下问题：对于包含破折号字符的模式名称，模式发现失败。

1.3.2 变更日志

2023 年 10 月 25 日发布

改进：

• 提高了 Relational Migrator 分析大型关系模式时的性能。

• Relational Migrator 现在与用于 SSL 连接的 Windows 证书存储区集成。

新增功能：

• 适用于 Mac M1 架构的新安装程序和二进制文件。

• 映射规则现在会显示用于生成_id字段的原始列和类型。

• 改进了查询转换器（私人预览版）中的错误消息。

1.3.1 变更日志

2023 年 10 月 10 日发布

新增功能：

• 能力在查询转换器（专属预览版）中为存储过程转换选择C# 、 Java和JavaScript语言。

• 现在，导出/导入项目时会包含查询转换。

缺陷修复：

• 修复更新事件可能在 CDC 作业中返回错误的问题。

• 修复 Relational Migrator 在尝试检测新版本是否可用时可能挂起的问题。

• 修复了为项目选择表时所有表可能会意外取消选中的问题。

• 改进Kafka部署模型（私有预览）下迁移作业的执行。

1.3.0变更日志

2023 年 9 月 26 日发布

新增功能：

• 查询转换器功能现已提供私有预览。

缺陷修复：

• SQL 服务器连接现在需要数据库名称，这解决了因推断数据库名称而引起的一些问题。

• 改进 Mac 和 Windows 安装程序。

1.2.0 变更日志

2023 年 9 月 4 日发布

新增功能：

• 能力更改迁移字段的数据类型。

• 能力控制空值在迁移数据中的表示方式。

• 能够将计算字段用于集合的_id值。

• 诊断转储包括有助于简化支持的配置文件。

缺陷修复：

• 改进映射规则中的验证和错误处理。

• 提高解析更广泛 Oracle DDL 文件的能力。

• 修复使用 SQL Server 和 Windows 身份验证刷新模式时表丢失的问题。

• 修复当表没有主键时 CDC 更新可能定位到错误文档的问题。

• 修复数据库密码可能错误保存到浏览器密码库的问题。

1.1.3 变更日志

2023 年 7 月 26 日发布

新增功能：

• 支持连接到 SQL 服务器命名实例。

• 现在，会显示从Code Generation屏幕创建的 JSON schema 文件的 collection 名称。

缺陷修复：

• 修复了迁移后作业问题，即数据验证有时会停止或显示为未启动。

• 修复了无法迁移包含顶级数组的 JSON 列的问题。

• 修复了排除的字段可能会覆盖同名的计算字段的问题。

• 修复了基于十进制列值的计算字段返回NaN的问题。

• 修复了更改项目级键处理选项后，某些图表视图字段被截断的问题。

1.1.2 变更日志

发布日期：2023 年 6 月 22 日

Relational Migrator 1.1.2 现已正式发布。 Relational Migrator 可协助您将关系工作负载迁移到 MongoDB。