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）实现隔离性。