MongoDB.local SF, Jan 15: See the speaker lineup & ship your AI vision faster. Use WEB50 to save 50%
Find out more >
Docs 菜单
Docs 主页
/
MongoDB Mongosync
/

mongosync 版本控制

Cluster-to-Cluster Sync使用语义版本控制 2.0.0。版本号的形式为 X.Y.Z,其中 X 为主要版本,Y 为次要版本,Z 为补丁版本。

MongoDB 使用以下准则来确定何时递增 Cluster-to-Cluster Sync 的版本号:

  • 主要版本号:该版本破坏了向后兼容性。

  • 次要版本号:该版本包含向后兼容的重要新功能。

  • 补丁号:此版本仅包含向后兼容的小型更改。

MongoDB 仅支持每个主要版本的最新补丁版本。 例如, mongosync 1.7.3是1.7的最新补丁版本。 如果您使用的mongosync版本不受支持,系统可能会要求您升级才能获得支持。

在运行 Cluster-to-Cluster Sync 之前,请考虑以下 MongoDB Server 版本限制和要求:

  • MongoDB 支持的最低服务器版本是 6.0.13 和 7.0.6。

  • mongosync 不支持 MongoDB 快速发布,例如 6.1 或 6.2。

  • 支持的最低服务器功能兼容性版本为6.0 。

从版本 1.2 开始, mongosync可以在运行某些较旧版本(6.0 之前)的集群之间同步MongoDB Server的各个版本。在 6.0 之前的版本中,此功能需要额外的准备和配置 发布。

如果您想迁移6.0 使用mongosync的MongoDB Server版本,请联系您的客户团队咨询专业服务。

从 1.7.0 开始, mongosync可以执行从较低主要版本源集群到较高主要版本目标集群的跨版本迁移。 您最多可以提前迁移两个主要版本。 例如,您可以将运行 MongoDB 6.0 的集群与运行 MongoDB 7.0 的集群进行同步。

从6.0之前的版本迁移时,跨版本迁移需要额外的准备和配置。 发布。 要从6.0 使用mongosync的 MongoDB Server 版本,请联系您的客户团队咨询专业服务。

Cluster-to-Cluster Sync 有以下与版本相关的注意事项:

  • 从该系列的第一个版本开始,主要版本的支持时间至少为一年。

  • 如果某个版本的 Cluster-to-Cluster Sync 仅适用于不支持的 MongoDB Server 版本,则该版本的 Cluster-to-Cluster Sync 也不受支持。

只有每个主要版本系列中的最新版本才会收到新的补丁版本。 例如,当发布 Cluster-to-Cluster Sync 2.1.0 版本时,2.0 版本将不再接收补丁版本。同时,1.3 版本将继续接收补丁,直到 1.4 版本发布。

1.7.0 版本的新增功能

mongosync 1.7.0 开始, 您可以升级mongosync ,而无需从头开始重新启动数据同步操作。 您只能从mongosync 1.6.0 或更高版本实时升级到mongosync 1.7.0 或更高版本。

实时升级后, mongosync会继续升级前正在进行的操作。

要实时升级mongosync ,请执行以下步骤:

1

要暂停mongosync ,请在每个运行的mongosync进程上运行 pause

您可以稍后从暂停状态恢复mongosync进程,如最后一步所示。

提示

如果您不想在实时升级后立即恢复数据同步操作,请考虑暂停mongosync进程。 如果您要协调多个mongosync进程的操作,这非常有用。

2

使用操作系统停止每个正在运行的mongosync进程。 要停止进程,请参阅操作系统文档了解具体步骤。

3

要下载并安装新的mongosync二进制文件,请参阅下载和安装 mongosync。

4

要初始化mongosync进程,请参阅快速入门。 在实时升级后的初始化期间, mongosync会更新持久性元数据。

5

如果您之前在可选的第一步中暂停了任何mongosync进程,请对所有mongosync进程运行resume

如果在实时升级之前已经在进行数据同步操作,则在实时升级后,可能无法全部支持最新mongosync版本中添加的新功能。 实时升级后始终支持性能改进和错误修复。 有关实时升级后可能支持的新功能的更多信息,请参阅1.7.0 版本。

如果您使用的是实时升级过程不支持的早期mongosync版本,或者需要降级mongosync ,请执行以下步骤:

  • 停止当前正在运行的所有mongosync进程。

  • 删除目标集群中的所有非系统数据库。

  • 安装新的mongosync二进制文件。

  • 使用新的二进制文件启动mongosync进程。

警告

新的mongosync进程不会恢复任何可能正在进行的工作。 启动新进程时,同步操作将从头开始。

在正常操作期间, mongosync会创建持久保存到目标数据库磁盘的元数据。 此元数据没有版本控制,可能随时更改。

日志消息格式没有版本控制,可能随时更改。 这包括对消息文本的更改,以及消息中其他字段是否存在或内容。

用户脚本和应用程序不应依赖日志输出。 脚本和应用程序应使用监控 API来确定mongosync的当前状态。

以下示例说明了可能导致每种版本号更新的变更类型。

  • 某些更改会导致新旧版本的mongosync在目标集群上针对同一组输入产生不同的结果。 不包括:

    • 修复了旧版本的mongosync无法复制数据的错误。

    • 当早期行为被明确记录为不支持时。

  • 更改已记录的 CLI 参数或配置键,导致mongosync拒绝以前有效的输入。 不包括:

    • 错误修复,例如解析或类型错误。

    • 尽管 CLI 参数或配置键可能已弃用,但记录的 CLI 参数或配置键的含义永远不会改变。 如果需要,新参数或键将替换旧的、已弃用的实体。

  • 破坏与受支持的 MongoDB Server 版本的兼容性的更改。

  • 删除 REST API 的一个版本。 mongosync可能会放弃所有旧端点,转而使用新版本的 API。 REST API 中永远不会出现任何其他类型的向后不兼容的更改。

  • 如果mongosync仍然支持支持该功能的 MongoDB Server 版本,则删除对以前支持的 MongoDB Server 功能的支持。

  • 如果mongosync已支持某个主要版本的 MongoDB Server,则需要新的权限才能继续支持该版本的 MongoDB Server。

  • 添加对以前不兼容的 MongoDB Server 版本的支持。

  • 对于以前不受支持的 MongoDB Server 主要版本,需要新的权限。

  • 添加对以前不支持的collection类型的支持。

  • 添加对以前不支持的索引类型的支持。

  • 在 REST API 中添加新端点、新字段或新接受的输入。

  • 添加新记录的 CLI 选项。

  • 添加新的配置键或接受的值。

  • 向后兼容的错误修复。

  • 性能回归修复。

  • 性能改进。

  • 帮助文本字符串的更改。

  • 对日志文本字符串的更改。

  • 对 API 响应中的信息文本进行更改,但不对“状态”等枚举样式的字符串字段进行更改。

  • 错别字修复。

后退

使用迁移验证程序

在此页面上