升级集群的 MongoDB 主版本
您可以随时通过修改集群来升级 Atlas 集群的主要版本。
为确保您顺利过渡到新的 MongoDB 版本并且不会影响您的应用程序，在生产 Atlas 集群上升级主要版本之前，请使用以下过程创建暂存集群并根据新的 MongoDB 版本测试您的应用程序。
注意事项
以下注意事项适用：
升级之前，您的集群必须处于正常状态。
如果在主要版本升级之前拍摄按需快照，请等到快照完成后再升级版本。
每次只能升级 Atlas 集群的一个主要版本。 升级集群时无法跳过任何主要版本。
每个主要版本都包含一些可能无法与以前版本向后兼容的功能。升级到新的主要版本时，请查看发布说明，了解可能影响应用程序的更改。或者，如果您使用Stable API ，则应确保 MongoDB 版本之间的行为更改不会在升级后破坏您的应用程序。
MongoDB 稳定版 API 包含MongoDB 命令的子集，应用程序使用这些命令读取和写入数据、创建集合和索引以及执行其他常见任务。 Stable API 允许您指定应用程序运行的 MongoDB API 版本，并为应用程序提供长期的 API 稳定性。它支持更频繁的发布和自动服务器升级，使您的应用程序能够利用快速发布的功能，而不必冒着向后不兼容更改的风险。
升级 MongoDB 主版本后，将无法降级到以前的版本。
从 MongoDB 4.4 升级到 MongoDB 5.0 可能会对性能产生影响。有关更多信息，请参阅性能注意事项。
从 MongoDB 6开始。 0 ，
$$SEARCH_META聚合变量不能在$searchMeta阶段之后的任何后续阶段中使用。如果您想从以前的版本升级到 MongoDB 6.0，并在 Atlas Search 使用
$searchMeta查询中使用$$SEARCH_META聚合变量，请在升级集群之前仔细检查，以免出错。
必需的访问权限
要升级集群，您必须具有项目的Project Owner或更高角色。
步骤
在 AtlasClusters 中，转到项目的 页面。
如果尚未显示，请选择包含所需项目的组织导航栏中的Organizations菜单。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
如果 Clusters（数据库部署）页面尚未出现，请单击侧边栏中的 Database（数据库）。
此时会显示“集群”页面。
为过渡环境创建 Atlas 集群。
注意
如果已经有 Atlas 集群作为过渡环境，则可以跳过此步骤。
单击Create按钮打开集群创建模式。配置暂存集群以匹配生产集群。您不必为暂存集群启用备份。
要了解如何创建新集群，请参阅创建集群。
重要
如果为暂存集群选择较小的集群层， 请考虑运行的任何性能测试 可能无法代表升级后的生产集群的性能。 您可能还需要根据 要镜像到暂存集群的数据量来选择更大的存储大小。
将您的暂存应用程序指向暂存集群。
更新暂存应用程序以指向暂存集群。有关检索暂存集群的 MongoDB 驱动程序友好连接字符串的说明，请参阅通过驱动程序连接。
确认应用程序可以成功连接到暂存集群并且应用程序按预期运行。
（可选）将您的应用程序升级到最新的 MongoDB 驱动程序。
将应用程序升级到适用于集群 MongoDB 版本的最新 MongoDB 驱动程序，即可完全访问较新 MongoDB 版本提供的功能。您还可能会发现较新的驱动程序版本具有更好的性能或稳定性。有关给定 MongoDB 版本推荐的 MongoDB 驱动程序的文档和连接示例，请参阅通过驱动程序连接。通过使用Stable API ，您可以确保 MongoDB 版本之间的行为更改不会破坏您的应用程序。
如果升级应用程序后遇到错误，请在 JIRA 项目中为您的 MongoDB 驱动程序提交工单。
在 AtlasClusters 中，转到项目的 页面。
如果尚未显示，请选择包含所需项目的组织导航栏中的Organizations菜单。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
如果 Clusters（数据库部署）页面尚未出现，请单击侧边栏中的 Database（数据库）。
此时会显示“集群”页面。
将生产集群升级为目标 MongoDB 版本。
对过渡集群的性能和运行有信心后，对生产集群重复升级步骤。
当 Atlas 完成升级过程后， 请检查生产应用程序是否仍然连接并正常运行。
如果使用较新的 MongoDB 驱动程序升级了暂存应用程序且对性能和运行感到满意，请考虑安排一个维护期来升级您的生产应用程序。
如果升级后的生产集群出现问题， 请使用以下部分的过程提交一个高优先级支持票证。
支持主要版本升级
如果您对迁移支持有任何超出本文档范围的问题， 或者在迁移过程中遇到错误， 请通过 Atlas 用户界面提交支持工单。
要提交支持票证：
在 Atlas 中，转到Project Support 页面。
如果尚未显示，请选择包含所需项目的组织导航栏中的Organizations菜单。
如果尚未显示，请从导航栏的Projects菜单中选择所需的项目。
在 Projects（项目）菜单旁边，展开 Options（选项）菜单，然后单击 Project Support（项目设置）。
显示“项目支持”页面。