MongoDB 4.2中的兼容性更改

MMAPv1特定配置选项¶

MongoDB删除了以下特定于MMAPv1的配置选项：

MMAPv1特定参数¶

MongoDB删除以下MMAPv1参数：

• newCollectionsUsePowerOf2Sizes
• replIndexPrefetch

MMAPv1特定命令¶

MongoDB删除MMAPv1特定touch命令。

MMAPv1命令和方法的特定选项¶

MongoDB删除了MMAPv1特定的选项：

• noPadding和usePowerOf2Sizes为collMod
• verbose 对于 collStats
• flags 对于 create
• paddingFactor，paddingBytes，preservePadding的 db.createCollection()。

删除对group命令的支持¶

从版本4.2开始，MongoDB删除group命令（自版本3.4起不推荐使用）及其mongo外壳帮助程序db.collection.group()。

而是db.collection.aggregate()与$group舞台一起使用。

删除对eval命令的支持¶

从4.2版开始，MongoDB删除该eval命令。eval 从3.0版开始不推荐使用该命令。

关联的MongoDB 4.2 mongoShell方法 db.eval()，db.collection.copyTo()仅在连接到MongoDB 4.0或更早版本时才能运行。

删除对copydband clone命令的支持¶

从版本4.2开始，MongoDB删除不推荐使用的copydb 命令和clone命令。

相应的mongoShell帮助程序 db.copyDatabase()，db.cloneDatabase()仅在连接到MongoDB 4.0或更早版本时才能运行。

作为替代方案，用户可以使用mongodump和 mongorestore（以及mongorestore选项 --nsFrom和--nsTo）或使用驱动程序编写脚本。

例如，要将test数据库从在默认端口27017上运行的本地实例复制到examples同一实例上的数据库，您可以：

mongodump --archive --db=test | mongorestore --archive  --nsFrom='test.*' --nsTo='examples.*'

删除对parallelCollectionScan命令的支持¶

从4.2版开始，MongoDB删除该parallelCollectionScan 命令。

删除maxScan¶

MongoDB删除了maxScan该 find命令和mongoshell助手 的不推荐使用的选项cursor.maxScan()。请使用命令maxTimeMS选项 find或帮助程序cursor.maxTimeMS()。

删除对geoNear命令的支持¶

从4.2版开始，MongoDB删除该geoNear命令。请使用$geoNear聚合阶段。

的选项$geoNear类似于已删除的 geoNear命令，但以下情况除外：

• 删除的geoNear命令在其输出dis中包含一个名为的字段 ，其中包含距离信息。

  对于$geoNear舞台，在中指定距离字段名称distanceField。

• 删除的geoNear命令接受包含字段boolean的includeLocs选项的值 loc。

  对于$geoNear阶段，在中指定位置字段名称includeLocs。

• 删除的geoNear命令包括avgDistance和 maxDistance的返回结果。

  您也可以使用聚合管道返回avgDistance 和maxDistance。具体而言，在该 $geoNear阶段之后，包括一个$group用于计算avgDistanceand 的阶段maxDistance：

  复制

  db.places.aggregate([
     { $geoNear: { near: <...>, distanceField: "dis", includeLocs: "loc", spherical: true, ... } },
     { $group: { _id: null, objectsLoaded: { $sum: 1 }, maxDistance:
           { $max: "$dis" }, avgDistance: { $avg: "$dis" } } }
  ])
  

  也可以看看

  从$ geoNear移除限制和num选项

删除对repairDatabase命令的支持¶

从4.2版开始，MongoDB删除repairDatabase命令及其mongoshell助手db.repairDatabase()以及repairDatabase特权。

作为替代：

• 要压缩的数据mongod，请使用 compact命令。有关操作的详细信息，请参见 compact命令。
• 要在独立服务器上重建索引，请使用reIndex 命令或其帮助器db.collection.reIndex()。有关操作的详细信息，请参见reIndex命令和 db.collection.reIndex()参考页。
• 要恢复独立数据，请使用。有关详细信息，请参见 意外关闭后恢复独立服务器。mongod --repair

删除对getPrevError命令的支持¶

从4.2版开始，MongoDB删除不推荐使用的 getPrevError命令及其mongoshell帮助器 db.getPrevError()。

弃用对cloneCollection¶

MongoDB弃用该cloneCollection命令及其 mongoshell助手db.cloneCollection()

作为替代方案

• 用户可以使用驱动程序来使用mongoexport和/ mongoimport或编写脚本。

不建议使用的计划缓存命令/方法¶

MongoDB弃用以下内容：

• PlanCache.getPlansByQuery() 方法/ planCacheListPlans命令。

  要获取形状的缓存查询计划，请改用 $planCacheStats聚合阶段。请参阅 查找高速缓存条目详细信息以获取查询形状。

• PlanCache.listQueryShapes() 方法/ planCacheListQueryShapes命令。

  要列出缓存的查询形状，请改用 $planCacheStats聚合阶段。请参阅 列表查询形状。

$out舞台限制¶

删除limit并num从选项$geoNear¶

从4.2版开始，MongoDB删除该阶段的limit和num 选项，$geoNear以及默认的100个文档限制。要限制的结果 $geoNear，请将$geoNear舞台与舞台一起 使用$limit。

例如，以下$geoNear 包含阶段的num选项的聚合在4.2中不再有效。

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "distance",
        num: 5,                 // Not supported in 4.2
        spherical: true
     }
   }
])

相反，您可以将聚合重写到以下管道：

db.places.aggregate([
   {
     $geoNear: {
        near: { type: "Point", coordinates: [ -73.99279 , 40.719296 ] },
        distanceField: "distance",
        spherical: true
     }
   },
   { $limit: 5 }
])

可用性¶

从MongoDB 4.2开始，无论是否支持读关注，更改流都可用"majority"。也就是说，majority可以启用阅读关注支持（默认）或禁用 以使用更改流。

在MongoDB 4.0和更早版本中，更改流仅在"majority"启用了阅读关注支持时才可用（默认）。

默认排序规则¶

从MongoDB 4.2开始，更改流将使用simple二进制比较，除非提供了明确的排序规则。在早期版本中，在单个集合（db.collection.watch()）上打开的更改流将继承该集合的默认排序规则。

恢复令牌修改¶

从MongoDB 4.2开始，如果更改流聚合管道修改了事件的_id字段，则更改流将引发异常。

FIPS模式¶

从4.2版开始，MongoDB删除--sslFIPSMode 以下程序的选项：

• mongodump
• mongoexport
• mongofiles
• mongoimport
• mongorestore
• mongostat
• mongotop

程序将使用FIPS兼容的连接 mongod/ mongos如果 mongod/ mongos实例 经配置以使用FIPS模式。

扩展JSON v2¶

从4.2版开始：

有关MongoDB扩展JSON v2的详细信息，请参阅 MongoDB扩展JSON（v2）。

mongoexport -d=test -c=records -q='{ "a": { "$gte": 3 }, "date": { "$lt": { "$date": "2016-01-01T00:00:00.000Z" } } }' --out=exportdir/myRecords.json

mongoexport -d=test -c=records -q='{ a: { $gte: 3 }, date: { $lt: { "$date": "2016-01-01T00:00:00.000Z" } } }' --out=exportdir/myRecords.json

主要降级¶

从MongoDB 4.2开始，replSetStepDown（并 replSetReconfig导致退出）不再关闭所有客户端连接。但是，正在进行的写入将被杀死。

在MongoDB 4.0和更低版本中，replSetStepDown在降级期间关闭所有客户端连接。

ROLLBACK状态¶

从4.2版开始，当成员进入ROLLBACK状态时，MongoDB会终止所有正在进行的用户操作。