ApsaraDB for MongoDB：MongoDB資料庫大版本升級說明

資料庫大版本

相容性變更說明

MongoDB 8.0

• 不建議使用tcmallocAggressiveMemoryDecommit。

• tcmallocReleaseRate參數可以指定具體的記憶體釋放速率，ApsaraDB for 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相容性變更說明。