MongoDB数据库大版本升级说明

数据库大版本

兼容性变更说明

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兼容性变更说明。