：MongoDB 3.6相容性更新說明

$type: "array"行為變更

自MongoDB 3.6版本起，type: "array"及$type: 4運算式將匹配包含任意元素類型的數組欄位。

在3.6之前的版本中，$type: "array" 僅匹配包含嵌套數組的數組欄位。

例如，集合 c 包含以下文檔：

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

以下操作通過欄位 a 的類型進行查詢：

db.c.find( { "a": { $type : "array" } } )

從3.6版本開始，此查詢將返回集合中的兩個文檔，因為 $type 查詢現在能檢測到欄位 a 本身是數組：

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

在MongoDB 3.4及更早版本中，此查詢僅返回欄位 a 包含BSON數群組類型元素的文檔：

{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

如果您當前的MongoDB執行個體版本為3.4.x並且正在使用partialFilterExpression包含$type: "array" 或 $type: 4的部分索引，則升級到3.6後必須重建這些索引，以避免因 $type: 'array' 語義變更引發衝突。

數組排序行為變更

自MongoDB 3.6版本起，當對包含數組的欄位進行排序時，MongoDB在升序排序中會以數組的最小元素值作為排序依據，降序排序則以數組的最大元素值為依據。排序時不再考慮查詢謂詞對數組元素的篩選。此行為變更適用於find命令和彙總管道操作。

當前依賴數組欄位排序的應用程式可能會因該變更導致排序結果與之前版本不同。

{ _id: 0, a: [-3, -2, 2, 3] }
{ _id: 1, a: [ 5, -4 ] }

db.coll.find({a: {$gte: 0}}).sort({a: 1});

// Documents.
{ "_id" : 1, "timestamps" : [ ISODate("2017-07-15T15:31:01Z"), ISODate("2017-07-21T18:31:01Z") ] }
{ "_id" : 0, "timestamps" : [ ISODate("2017-07-21T15:31:01Z"), ISODate("2017-07-21T13:31:01Z") ] }

// Query.
db.c.aggregate([{$sort: {timestamps: -1}}])

// Documents.
{_id: 0, a: [3, 1, 5]}
{_id: 1, a: [3, 4, 0]}

// Query.
db.coll.aggregate([{$sort: {a: 1}}])

新增欄位的更新

自MongoDB 3.6起，通過更新操作添加的新欄位會按字典序（lexicographic order）追加。

例如，集合 coll 包含文檔：

{ _id: 0, x: 0 }

執行更新操作添加兩個新欄位：

db.coll.update({_id: 0}, {$set: {b: 0, a: 0}})

在3.6版本中，新欄位按字典序追加，更新後文檔為 {_id: 0, x: 0, a: 0, b: 0}。

在3.6之前的版本中，新欄位按更新文檔中的出現順序追加，結果為 {_id: 0, x: 0, b: 0, a: 0}。

與arrayFilters標識符衝突的欄位

自MongoDB 3.6起，若欄位名與arrayFilters的標識符文法（如 $[]）衝突，則無法更新該欄位。

例如，集合 coll 包含文檔：

{ _id: 0, x: { "$[]": 0 } }

執行更新操作：

db.coll.update({_id: 0}, {$set: {"x.$[]": 1}})

在3.6之前的版本中，更新操作將執行成功。在3.6版本中，因欄位名 $[] 與arrayFilters文法衝突，將操作失敗。

對$pop操作符實施更嚴格的驗證

自MongoDB 3.6起，$pop 操作符的參數必須以下值：

• -1：移除數組的第一個元素。

• 1：移除數組的最後一個元素。

在3.6之前的版本中：

• 任意負數均可移除首元素。

• 任意非負數或非數值均可移除末尾元素。

移除$pushAll操作符

MongoDB 3.6移除了$pushAll 操作符（自2.4版起標記為棄用）。

請使用 $push + $each 操作符實現相同功能。樣本如下：

db.students.update(
   { name: "joe" },
   { $push: { scores: { $each: [ 90, 92, 85 ] } } }
)

棄用MONGODB-CR認證機制

自MongoDB 3.6起，MONGODB-CR認證機制已被標記為棄用。若仍在使用MONGODB-CR認證模式，需立即升級至更安全的SCRAM認證。

仲裁節點（Arbiter）與優先順序

所有仲裁節點（Arbiter）的優先順序固定為 0。

棄用主從複製架構

MongoDB 3.6正式棄用主從複製（Master-Slave Replication）架構。

棄用WiredTiger儲存引擎的--nojournal選項

在3.6版本中，對使用WiredTiger儲存引擎的複本集成員，棄用--nojournal選項，以避免產生資料風險。

調整aggregate命令及返回結果

自MongoDB 3.6起，aggregate命令不再支援以單文檔形式返回結果。

執行aggregate命令時，必須指定以下選項之一：

• cursor：以遊標形式返回結果（適用於巨量資料集）。

• explain：返回彙總管道的執行計畫分析。

建議您優先使用mongo shell中的db.collection.aggregate()，或對應驅動程式的等效方法。除非使用explain選項，否則這些方法預設返回遊標。

變更彙總中日期轉字串格式

自MongoDB 3.6版本起，在彙總運算式中將日期類型強制轉換為字串時，結果將包含毫秒級精度，並以字母 'Z' 結尾（表示UTC時區）。

樣本如下：

// Documents.
{_id: 0, d: ISODate("2017-10-18T20:04:27.978Z")}
{_id: 1, d: ISODate("2017-10-18T20:04:28.192Z")}

// Query.
db.coll.aggregate({$project: {d: {$toLower: "$d"}}})

在MongoDB 3.6之前版本中，返回字串格式為 "2017-10-18t20:04:27" 和 "2017-10-18t20:04:28"。

在MongoDB 3.6及之後版本中，返回字串格式為 "2017-10-18t20:04:27.978z" 和 "2017-10-18t20:04:28.192z"（含毫秒及小寫'z'）。

受影響的彙總操作符包括：

• $concat

• $substr

• $substrBytes

• $substrCP

• $strcasecmp

• $toLower

• $toUpper

移除診斷記錄命令與選項

MongoDB 3.6移除了已棄用的 diagLogging 命令及 mongod --diaglog 選項。

替代方案：使用 mongoreplay 工具捕獲、回放及分析發送到MongoDB部署的命令。

validate操作變更

自MongoDB 3.6版本起，僅當執行完整驗證（full validation）時，validate 操作會強制觸發檢查點（checkpoint），將所有記憶體資料刷盤後再驗證磁碟資料。

在3.6之前的版本中，無論驗證模式如何，均強制觸發檢查點。

當您使用 validate 命令或 db.collection.validate() 方法時，需明確指定 {full: true} 以執行完整驗證。

索引名稱限制

自MongoDB 3.6版本起：

• 禁止建立名為 * 的索引：無法在建立索引時指定名稱 *。

• 無法通過索引鍵刪除名為 * 的索引：需直接通過索引名稱刪除。

在升級至MongoDB 3.6版本前，您需要：

• 刪除現有 * 索引：在升級前手動刪除所有名為 * 的索引。

• 重新命名索引：若需保留索引，需先刪除再重建並指定新名稱。

棄用選項

3.6.1版本變更。

• 棄用 snapshot 查詢選項

  • MMAPv1儲存引擎：改用 hint({ _id: 1 }) 確保查詢期間文檔不被重複返回（即使中間寫入導致文檔移動）。

  • 其他儲存引擎（如WiredTiger）：改用 hint({ $natural: 1 })。

• 棄用 $isolated 操作符

  • 替代方案：通過事務或調整讀寫關注（read concern）實現隔離性。