MongoDB 5.0 中的兼容性更改

某些命令只接受可被识别的参数

从 MongoDB 5.0 开始，如果传递的参数未被命令显式接受，则某些数据库命令会抛出错误。在 MongoDB 4.4 及更早版本中，无法被识别的参数会被默默忽略。

受影响的命令：

• abortTransaction

• aggregate

• authenticate

• collMod

• commitTransaction

• create

• createIndexes

• delete

• drop

• dropDatabase

• dropIndexes

• endSessions

• explain

• find

• findAndModify

• getMore

• hello

• insert

• killCursors

• listCollections

• listDatabases

• listIndexes

• ping

• refreshSessions

• update

已删除的命令

从 MongoDB 5.0 开始，已删除以下数据库命令和 mongo Shell 助手方法：

删除的参数

MongoDB 5.0 删除了以下服务器参数：

已删除的索引类型

MongoDB 5.0 删除了已弃用的 geoHaystack 索引。改用 2d 索引。

将 MongoDB 实例升级到 5.0 并将 FeatureCompatibilityVersion 设置为 5.0 会删除所有先前存在的 geoHaystack 索引。

已删除的指标

从 MongoDB 5.0 开始，serverStatus 命令不会输出 opReadConcernCounters，其中包含查询操作指定的读关注（read concern）级别。新的 readConcernCounters 取代了 opReadConcernCounters，并包含其他信息。

从 MongoDB 5.0 开始，serverStatus 命令不会输出 wiredTiger.snapshot-window-settings 下的 cache pressure percentage threshold 和 current cache pressure percentage。

删除了对 Raspberry Pi 的支持

MongoDB 5.0 移除了对 Raspberry Pi 的支持。要在 Raspberry Pi 上运行 MongoDB，请安装版本 4.4。

设置为 NaN 时的 TTL expireAfterSeconds 行为

从 MongoDB 5.0 开始，将 expireAfterSeconds 设置为 NaN 的 TTL 索引与早期版本相比发生了行为更改。

此行为更改会影响：

• 直接升级

• 早期版本的初始同步

• mongorestore 早期版本的

执行任意上述操作均会导致 NaN 的 expireAfterSeconds 值被视为 0 的 expireAfterSeconds。这可能会导致文档立即过期。

从 MongoDB 5.0.14（和 6.0.2）开始，服务器将不再使用将 expireAfterSeconds 设置为 NaN 的 TTL 索引。

Shell 变更

mongo Shell 在 MongoDB v5.0 中已被弃用。替换 Shell 为 mongosh。

MongoDB v5.0 中的 Shell 打包方式也有变更。更多详情，请参阅安装说明。

副本集

if [ (#arbiters > 0) AND (#non-arbiters <= majority(#voting-nodes)) ]
    defaultWriteConcern = { w: 1 }
else
    defaultWriteConcern = { w: "majority" }

针对固定大小集合的读关注 snapshot

从 MongoDB 5.0 开始，从固定大小集合进行读取时无法使用读关注（read concern） "snapshot"。

local 为默认读关注（read concern）

从 MongoDB 5.0 开始，"local" 是针对主节点和从节点的读取操作的默认读关注（read concern）级别。

对于使用过滤器的计数查询以及覆盖查询来说，这可能会导致显著的延迟增长。

您可以通过使用 setDefaultRWConcern 设置集群范围的读关注（read concern）来更改此默认行为。

新增 cursor.map() 返回类型

cursor.map() 在旧版 mongo shell 中返回 Array。返回类型为 mongosh 中的 Cursor。您可以使用 .toArray() 来转换结果。

更新操作符变更

从 MongoDB 5.0 开始，使用以下带空操作数表达式 ({ }) 的更新操作符时，mongod 不会再抛出错误。

• $addToSet

• $bit

• $currentDate

• $inc

• $max

• $min

• $mul

• $pop

• $pull

• $pullAll

• $push

• $rename

• $set

• $setOnInsert

• $unset

空更新不会导致任何变化，也不会创建 oplog 条目（意味着该操作为“无操作”）。

$setWindowFields 具有事务和快照读取关注的阶段

在 5.3 之前的 MongoDB 版本中，$setWindowFields 聚合管道阶段不能与事务或 "snapshot" 读关注一起使用。

聚合管道操作符参数限制

以下聚合管道操作符现在有 64 位整数值的最大限制。

• $sort

• $limit

如果传递的值超过此限制，管道将返回无效参数错误。

listDatabases 输出变更

从 MongoDB 5.0 开始，针对 mongod 运行的 listDatabases 命令与针对 mongos 运行的 listDatabases 有更加一致的输出。

下表显示了 MongoDB 5.0 和早期版本之间 listDatabases 输出字段的数据类型差异。下表仅列出了在 5.0 版本和早期版本之间存在差异的字段。

现在，在对 mongos 或 mongod 运行时，listDatabases 的输出包含了 totalSizeMb 字段。在 MongoDB 4.4 及更早版本中，totalSizeMb 仅在对 mongos 运行时出现。totalSizeMb 是 sizeOnDisk 字段的总和，以兆字节为单位。

在对 mongos 运行时，listDatabases 输出中的 shards 字段包含特定分片上每个集合的字段-值对。shards 字段中的大小值将以整数表示。

安全性

Map-Reduce

从 5.0 版开始，MongoDB 弃用了 map-reduce 操作。

有关 map-reduce 操作的聚合管道版替代方案的示例，请参阅 Map-Reduce 到聚合管道和 Map-Reduce 示例

审核

MongoDB 5.0 新增了可以在运行时配置的审核功能。

如果将 auditLog.runtimeConfiguration 设置为 true， mongod 和 mongos 配置文件将无法再设置 setParameter.auditAuthorizationSuccess 或配置审核过滤器。如果服务器配置文件包含这些设置，服务器将无法启动并记录错误。

如果将 auditLog.runtimeConfiguration 设置为 false 并且存在审核过滤器配置文档，则服务器会发出启动警告，但不会中止。

降低分片事务中数据块过期的风险

从 MongoDB 5.0 开始，如果您更改了 transactionLifetimeLimitSeconds 参数，您还必须在所有配置服务器副本集节点上将 transactionLifetimeLimitSeconds 更改为相同的值。保持该值一致将会：

• 确保路由表历史记录的保留时间至少达到分片副本集成员的事务生命周期限制。

• 降低事务重试频率，从而提高性能。

一般性变更

从 MongoDB 5.0 开始：

• 如果将 featureCompatibilityVersion 设置为 "5.0" 或更高版本，用户将无法再直接向 <database>.system.views 集合写入数据。

• reIndex 命令和 db.collection.reIndex() Shell 方法只能在独立运行的实例上运行。

• 单个管道中允许的聚合管道阶段最大数量为 1000 个。

• 当启用了 directoryPerDB 或 --directoryperdb 时，删除数据库中的最后一个集合（或删除数据库本身）将删除该数据库新的空子目录。

• 如有必要，$subtract 聚合操作符将转换结果的数据类型，以便准确表示结果值。有关具体的转换，请参阅 $subtract。

• MongoDB 删除 --serviceExecutor 命令行选项和相应的 net.serviceExecutor 配置选项。

• 如果设置了 --apiStrict 选项，就不能在同一客户端会话中同时以多个用户身份进行身份验证。如果设置了 --apiStrict 选项，则当前现有用户身份登录后，如果尝试以新用户身份进行身份验证，将在每次身份验证尝试时生成一条错误消息。如果不使用 --apiStrict选项，则当前以现有用户身份登录后，如果以新用户身份进行身份验证，将在每次身份验证尝试时向日志写入一次警告。

• 只有 $text 索引才允许使用 权重 选项。

• 在尝试使用会改变隐式默认写关注（write concern）的配置重新配置一个非分片的副本集之前，您必须显式设置全局默认写关注。要设置全局默认写关注，请使用 setDefaultRWConcern 命令。

• 要在 mongosh 中设置 replSetOplog 大小，请使用 Double() 构造函数和 replSetResizeOplog 命令。

5.0 功能兼容性

5.0 中的某些功能不仅需要 5.0 二进制文件，还需要将 featureCompatibilityVersion (fCV) 设置为 5.0。这些功能包括：

• 创建时间序列集合需要将 fCV 设置为 5.0+。

• 配置运行时审核过滤器管理需要将 fCV 设置为 5.0+。

• 在字段名称中使用 . 和 $ 需要将 fCV 设置为 5.0+。

• 重新分片集合需要将 fcV 设置为 5.0+。