MongoDB数据库大版本的注意事项及说明 - 云数据库 MongoDB

云数据库MongoDB支持升级数据库大版本。升级前，建议您了解不同产品架构、不同版本的实例支持升级到的数据库大版本以及不同数据库大版本的兼容性变更说明。

支持升级的数据库大版本

云数据库 MongoDB 版控制台可以直接升级数据库大版本，但不同产品架构、不同版本的实例支持升级的版本不同，具体情况如下：

产品架构	规格类型	实例的数据库大版本	可升级到的数据库大版本
单节点架构	通用型云盘版	MongoDB 4.0	暂无更高的数据库大版本可升级。
单节点架构	通用型云盘版	MongoDB 3.4	不支持升级数据库大版本。如果您需要升级数据库大版本，可以通过创建新实例，使用新实例替换旧实例。
副本集架构	通用型云盘版独享型云盘版	MongoDB 8.0	暂无更高的数据库大版本可升级。
		MongoDB 7.0	MongoDB 8.0
		MongoDB 6.0	MongoDB 7.0
		MongoDB 5.0	MongoDB 6.0
		MongoDB 4.4	MongoDB 5.0 实例从4.4升级到5.0后，由于默认的writeConcern从`{w:1}`调整为`{w:majority}`，可能会导致写入性能退化，写入延迟上升。请确认此变更带来的影响后，再进行大版本升级。
	通用型本地盘版独享型本地盘版独占物理机	MongoDB 4.2	不支持升级数据库大版本。如果您需要升级数据库大版本，可以通过创建新实例，使用新实例替换旧实例。
		MongoDB 4.0	MongoDB 4.2
		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
		MongoDB 3.2
		MongoDB 3.0
分片集群架构	独享型云盘版	MongoDB 8.0	暂无更高的数据库大版本可升级。
		MongoDB 7.0	MongoDB 8.0
		MongoDB 6.0	MongoDB 7.0
		MongoDB 5.0	MongoDB 6.0
		MongoDB 4.4	MongoDB 5.0 实例从4.4升级到5.0后，由于默认的writeConcern从`{w:1}`调整为`{w:majority}`，可能会导致写入性能退化，写入延迟上升。请确认此变更带来的影响后，再进行大版本升级。
	通用型本地盘版独享型本地盘版独占物理机	MongoDB 4.2	不支持升级数据库大版本。如果您需要升级数据库大版本，可以通过创建新实例，使用新实例替换旧实例。
		MongoDB 4.0	MongoDB 4.2
		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
		MongoDB 3.2
		MongoDB 3.0

如果您需要跨产品架构或跨存储类型升级实例大版本，可以先创建目标高版本实例，然后通过DTS将源实例迁移至高版本的新实例中。

迁移数据的方法如下：

大版本兼容性变更说明

不同数据库大版本的兼容性变更说明如下：

重要

升级数据库大版本时，实例的状态需为运行中。如何升级数据库大版本，请参见升级数据库版本。
升级数据库大版本后不支持降级。
MongoDB 4.0及以上大版本已兼容MongoDB 3.6。如果您需要使用MongoDB 3.6大版本的功能，请升级到MongoDB 4.0及以上大版本。
兼容性变更说明仅包含云数据库MongoDB内核的变更，不包含MongoDB实例管控功能的变更。

数据库大版本	兼容性变更说明
MongoDB 8.3	如果创建了使用 MongoDB 8.3 新引入表达式、参数或变量的视图或集合 validator，降级后，这些视图可能无法正常工作，对象可能无法通过验证或求值。 MongoDB 8.3 可以使用新的验证语义将集合标记为“已验证（validated）”，该语义与 8.3 之前的版本不兼容。如果在存在已验证集合时尝试降级，降级会失败。从 MongoDB 8.3 开始，当 `$facet` 阶段构造的文档超过 100MB 限制时，MongoDB 返回 `ExceededMemoryLimit` 错误的错误码从4031700变为146。如果你的应用、驱动或工具显式检查 4031700，需要更新代码以识别新的 `ExceededMemoryLimit` 错误码。从 MongoDB 8.3 降级到更早版本时，`activeBalancerWindowDOW`（按星期几配置均衡窗口）配置不可用。 `removeShard`命令已弃用。推荐改用`startShardDraining`、`stopShardDraining`、`shardDrainingStatus`、`commitShardRemoval`四个新命令来控制分片删除流程，支持随时暂停和恢复迁移。在分片集群上，DDL 操作和 `applyOps` 现在必须通过 mongos 执行，不能直接在分片节点上运行。 `2dsphereVersion`默认值从3升级至4。如需将FCV降级至8.3以下版本，必须先删除所有version 4的2dsphere索引。从8.3（以及8.0.18, 7.0.29）开始，复合通配符索引的`wildcardProjection`规范采用了更严格的验证规则。现有索引即使不符合新的验证要求也能继续运行，但无法再创建不符合这些要求的新索引。关于时间序列集合，`refineCollectionShardKey`要求分片键引用逻辑元数据和时间字段，不再接受底层存储桶格式；索引不能命名为`_id_`；`timeField`名称不能以`$`开头。 `serverStatus`输出已移除`service`字段。移除`config.csrs.indexes` 系统集合。 MongoDB 8.3的更多信息，请参见Compatibility Changes in MongoDB 8.3。
MongoDB 8.0	不建议使用`tcmallocAggressiveMemoryDecommit`。 `tcmallocReleaseRate`参数可以指定具体的内存释放速率，云数据库MongoDB版默认为10MB/s。当`null`作为查询条件时，MongoDB不会再匹配`undefined`值。不建议使用index filter。时间序列集合不建议使用`timeField`作为分片键。不建议使用`cleanupOrphaned`命令。不允许并发执行同一集合的`compact`命令。在升级MongoDB 8.0版本前，您需要重命名或删除名为`system.buckets`的非时间序列集合。 MongoDB 8.0的更多信息，请参见Compatibility Changes in MongoDB 8.0。
MongoDB 7.0	将大版本升级至MongoDB 7.0场景，目前不存在兼容性问题。如果需要将MongoDB 7.0版本降级至其他大版本，则需要先移除7.0版本支持的功能，例如：删除所有柱状索引（`columnar indexes`）。注销通过`setClusterParameter`命令设置的集群参数。具体信息，请参见setClusterParameter。删除所有使用`encryptedFields`选项创建的集合。删除所有的复合通配符索引（`Compound wildcard indexes`）。 MongoDB 7.0的更多信息，请参见Compatibility Changes in MongoDB 7.0。
MongoDB 6.0	如果聚合管道里使用的内存超过了100 MB，默认会写入数据到磁盘的临时文件中。若要更改此默认行为，请修改全局参数`allowDiskUseByDefault`为`false`。 6.0之前的版本需要显式指定`{ allowDiskUse: true }`参数，才能写入数据到磁盘的临时文件中。通过`dropIndexes`删除索引时，如果使用通配符`*`，不会删除`_id`索引，也不会删除分片键索引，更多信息，请参见dropIndexes。不再支持Mongo Shell工具，请使用mongosh工具替代。不再支持`$explain`、`$hint`、`$max`和`$maxTimeMS`等操作符。当TTL索引`expireAfterSeconds`被设置为`NaN`时，会被认为设置为`0`，可能会立马淘汰过期文档。不再支持`SCRAM-SHA-1`认证方法。不再支持`reIndex`命令以及相对应的`reIndex()`方法。 MongoDB 6.0的更多信息，请参见Compatibility Changes in MongoDB 6.0。
MongoDB 5.0	Secondary节点（从节点）的`Read Concern`级别从`available`变更为`local`，更多信息，请参见Read Concern。 `Write Concern`的默认值由`1`变更为`majority`。重要此调整可能会导致实例的写入性能退化，请确认影响之后再进行大版本升级操作。此外，您也可以使用setDefaultRWConcern命令修改数据库的默认writeConcern。不再支持`db.collection.ensureIndex()`，请使用`db.collection.createIndex()`替代。对`saslStart`以及`saslContinue`命令的参数进行严格校验，无法兼容`mgo`。`saslContinue`只需要`conversationId`和`payload`参数，而`mgo`提供了一个多余的参数 `mechanism`，更多信息，请参见mgo。删除`geoSearch`。 MongoDB 5.0的更多信息，请参见Compatibility Changes in MongoDB 5.0。
MongoDB 4.4	`compact`不再支持`force`选项，更多信息，请参见compact。不再支持`geoSearch`，更多信息，请参见geoSearch。支持在主备数据库上同时创建索引，以减少索引创建带来的主备延迟。即使在索引创建过程中，也可以保证备库访问到最新的数据。 MongoDB 4.4的更多信息，请参见Compatibility Changes in MongoDB 4.4。
MongoDB 4.2	不再支持`geoNear`，请使用`$geoNear (aggregation)`替代，更多信息，请参见$geoNear (aggregation)。不再支持`repairDatabase`。不再支持并删除`cloneCollection`，请使用`mongoexport`和`mongoimport`替代，更多信息，请参见mongoexport和mongoimport。不再支持`afterClusterTime`，更多信息，请参见afterClusterTime。开源MongoDB 4.2+兼容驱动默认启用Retryable Writes，更多信息，请参见Retryable Writes。删除`group`、`copydb`和`clone`。 MongoDB 4.2的更多信息，请参见MongoDB 4.2兼容性更新说明。
MongoDB 4.0	`reIndex`添加一个全局写锁，直到索引重建完成，更多信息，请参见reIndex。不再支持`copydb`和`clone`。 MongoDB 4.0的更多信息，请参见MongoDB 4.0兼容性更新说明。
MongoDB 3.6	`aggregate`不再支持返回单个文档，而是返回`cursor`。用户可以通过`cursor`指定`batch`的规格。`aggregate`的更多信息，请参见aggregate。 `$type: "array"`能直接检测到数组类型的文档，之前只能检测到嵌套型的数组类型文档。`$type`的更多信息，请参见$type。数组排序结果，发生以下变更： `find`中新增可选项`sort`，用于提供排序结果明细。`find`的更多信息，请参见find。 `$sort(aggregation)`中`$sort stage`的内存限制为100 MB，更多信息，请参见$sort (aggregation)。在进行更新操作时，如果需要同时更新多个字段，新字段将按照字典顺序添加，更多信息，请参见$set。不再支持`snapshot`查询选项。 MongoDB 3.6的更多信息，请参见MongoDB 3.6兼容性更新说明。
MongoDB 3.4	不再支持`group`，请使用`db.collection.aggregate()`或者`db.collection.mapReduce()`替代。更多信息，请参见db.collection.aggregate()和db.collection.mapReduce()。使用`$in`表达式匹配`+ upsert: true`的`update`。示例： `db.c.drop() db.c.update({a:{$in:[1]}},{$addToSet:{a:2}},{upsert:true}) //在MongoDB 3.4插入会失败，MongoDB 3.4之前的大版本可成功插入一条记录。 db.c.update({a:{$elemMatch:{$in:[2]}}},{$addToSet:{a:2}},{upsert:true}) //在MongoDB 3.4可成功插入一条记录。` `update`的更多信息，请参见update。 MongoDB 3.4的更多信息，请参见MongoDB 3.4兼容性变更说明。

接口	说明
UpgradeDBInstanceEngineVersion	升级云数据库MongoDB实例的数据库大版本。

云数据库 MongoDB：MongoDB数据库大版本升级说明

支持升级的数据库大版本

大版本兼容性变更说明

相关API