數據庫大版本

兼容性變更說明

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。

• 不再支持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的更多信息，請參見Compatibility Changes in MongoDB 4.2。

MongoDB 4.0

• reIndex添加一個全局寫鎖，直到索引重建完成，更多信息，請參見reIndex。

• 不再支持copydb和clone。

MongoDB 4.0的更多信息，請參見Compatibility Changes in 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的更多信息，請參見Compatibility Changes in 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的更多信息，請參見Compatibility Changes in MongoDB 3.4。