MongoDB 2.6中的兼容性更改

MongoDB 中文手册

参考 > 发行说明 > MongoDB 2.6发行说明 > MongoDB 2.6中的兼容性更改

在本页面

指数变化
写方法确认
db.collection.aggregate() 更改
写关注验证
安全变更
2dsphere 索引版本2
日志信息
软件包配置更改
删除方法签名更改
更新运算符语法验证
更新实施字段名称限制
查询和排序更改
副本集/共享群集验证
时间格式变更
其他资源

以下2.6更改可能会影响与旧版MongoDB的兼容性。有关2.6更改的完整列表，请参阅MongoDB 2.6发行说明。

指数的变化¶

强制索引键长度限制¶

描述

MongoDB 2.6对上的限制实施了更强大的实施。index key

如果现有文档中的索引键超出限制，则创建索引将出错：

db.collection.ensureIndex()， db.collection.reIndex()，compact，和 repairDatabase会报错，而不是创建索引。MongoDB的早期版本将创建索引，但不会为此类文档建立索引。
因为db.collection.reIndex()，compact和会repairDatabase删除集合中的所有索引，然后按顺序重新创建它们，所以索引键限制中的错误会阻止这些操作为该集合重建任何剩余的索引，并且对于该repairDatabase命令，将阻止继续执行其余的索引。过程。

插入错误：

db.collection.insert()并执行插入物（例如其他操作db.collection.save()和 db.collection.update()与upsert该结果在插入）将无法插入如果新文档具有一个索引字段，其对应的索引条目超出了限制。MongoDB的早期版本将插入但不会索引此类文档。
mongorestoremongoimport如果新文档的索引字段的索引条目超出限制，则将无法插入。

更新将错误：

db.collection.update()并 db.collection.save()在索引字段操作如果更新的值会导致索引条目超过极限就会报错。
如果现有文档包含索引项超过其索引条目的索引字段，则导致在磁盘上重新定位文档的其他字段的更新将出错。

块迁移将失败：

对于具有文档中包含索引字段超过索引限制的索引字段的文档的块，迁移将失败。
如果不固定，该块将反复失败迁移，从而有效地停止了该集合的块平衡。或者，如果响应于迁移失败而发生了块拆分，则此响应将导致不必要的大量块和过多的配置数据库。

副本集的次要成员将警告：

辅助节点将继续使用索引字段（其对应的索引条目超过初始同步限制）复制文档，但将在日志中显示警告。
辅助数据库允许对包含索引字段的集合进行索引构建和重建操作，该索引字段的相应索引条目超过了限制，但日志中有警告。
对于辅助版本为2.6和主版本为2.4的混合版本副本集，辅助副本将复制在2.4主数据库上插入或更新的文档，但是如果文档包含索引字段的索引字段超过其对应的索引条目，则将在日志中显示错误消息限制。

解

运行db.upgradeCheckAllDBs（）以查找违反此限制的当前密钥，并进行适当的更正。最好在升级前运行测试；例如，将2.6 mongoShell 连接到您的MongoDB 2.4数据库并运行该方法。

如果您具有现有数据集，并且想要禁用默认索引键长度验证，以便可以在解决这些索引问题之前进行升级，请使用failIndexKeyTooLong参数。

指数技术指标验证字段名称¶

描述

在MongoDB 2.6中，当索引键指向一个空字段时，例如，或者字段名称以美元符号（）开头，创建和重新索引操作将失败。"a..b" : 1$

db.collection.ensureIndex() 不会使用无效或空的键名称创建新索引。
db.collection.reIndex()，compact以及 repairDatabase将如果一个指数具有无效或空键名称存在错误。
如果存在具有无效或空键名的索引，则块迁移将失败。

MongoDB的早期版本允许索引。

解

`ensureIndex`与现有索引¶

描述

db.collection.ensureIndex() 现在错误：

如果您尝试创建现有索引但具有不同的选项；例如在下面的示例中，第二个 db.collection.ensureIndex()将出错。
复制
```
db.mycollection.ensureIndex( { x: 1 } )
db.mycollection.ensureIndex( { x: 1 }, { unique: 1 } )
```
如果指定的索引名称已经存在，但键的规格不同；例如在下面的示例中，第二个 db.collection.ensureIndex()将出错。
复制
```
db.mycollection.ensureIndex( { a: 1 }, { name: "myIdx" } )
db.mycollection.ensureIndex( { z: 1 }, { name: "myIdx" } )
```

以前的版本没有创建索引，但是没有错误。

Write方法致谢¶

描述: 该mongo外壳写入方法 db.collection.insert()，db.collection.update()， db.collection.save()和db.collection.remove() 现在整合写入关注直接进入方法，而不是一个单独的 getLastError命令，以提供写入确认是否在交互运行 mongo的脚本壳或以非交互方式。在以前的版本中，这些方法表现出“一劳永逸”的行为。 [1]

mongo使用这些方法的Shell的现有脚本现在将等待确认，该确认花费的时间比以前的“一劳永逸”行为更长。
现在，write方法将返回一个WriteResult对象，其中包含操作结果，包括任何写错误和写关注错误，并且无需调用 getLastError命令来获取结果的状态。见db.collection.insert()， db.collection.update()，db.collection.save() 并db.collection.remove()了解详细信息。
在分片环境中，mongos不再支持“解雇”行为。将数据写入分片群集时，这会限制吞吐量。

[1]	在以前的版本中，当以`mongo`交互方式使用外壳程序时，`mongo`外壳程序会`getLastError`在write方法之后自动调用命令以提供对写入的确认。但是，除非脚本在write方法之后包含对命令的显式调用，否则脚本将在以前的版本中观察到“即发即弃”的行为 `getLastError`。

解

将这些mongo外壳程序方法用于具有“即发即忘”行为的批量写入操作的脚本应使用这些 Bulk()方法。

在分片环境中，插入或修改文档组时，使用任何驱动程序或mongo外壳程序的应用程序应使用Bulk()方法以实现最佳性能。

例如，代替：

复制

for (var i = 1; i <= 1000000; i++) {
    db.test.insert( { x : i } );
}

在MongoDB 2.6中，替换为Bulk()操作：

复制

var bulk = db.test.initializeUnorderedBulkOp();

for (var i = 1; i <= 1000000; i++) {
    bulk.insert( { x : i} );
}

bulk.execute( { w: 1 } );

批量方法返回一个BulkWriteResult包含操作结果的对象。

也可以看看

新的写操作协议， Bulk()， Bulk.execute()， db.collection.initializeUnorderedBulkOp()， db.collection.initializeOrderedBulkOp()

`db.collection.aggregate()`变更¶

描述

Shell中的db.collection.aggregate()方法 mongo默认为将游标返回到结果集。此更改使聚合管道可以返回任何大小的结果集，并且需要迭代游标才能访问结果集。例如：

复制

var myCursor = db.orders.aggregate( [
    {
      $group: {
         _id: "$cust_id",
         total: { $sum: "$price" }
      }
    }
] );

myCursor.forEach( function(x) { printjson (x); } );

早期版本返回的单个文档的字段results 包含结果集数组，但要遵守BSON文档的大小限制。访问MongoDB早期版本中的结果集需要访问该 results字段并迭代该数组。例如：

复制

var returnedDoc = db.orders.aggregate( [
    {
      $group: {
         _id: "$cust_id",
         total: { $sum: "$price" }
      }
    }
] );

var myArray = returnedDoc.result; // access the result field

myArray.forEach( function(x) { printjson (x); } );

解

更新当前希望db.collection.aggregate()返回带有results数组的文档的脚本来代替处理游标。

也可以看看

聚集增强， db.collection.aggregate()，

写关注验证¶

描述: 现在指定包含使用选项运行的或实例的写入关注错误。以前的版本会忽略。j: truemongodmongos--nojournalj: true
解: 当针对带有或运行或带有日志的或实例发布规范时，可以从写关注中删除该规范。j: truemongodmongos--nojournalmongodmongos

安全性更改¶

新的授权模型¶

描述

MongoDB 2.6 授权模型更改了MongoDB存储和管理用户特权信息的方式：

升级之前，MongoDB 2.6在管理数据库中至少需要一个用户。
使用较旧模型的MongoDB版本无法创建/修改用户或创建用户定义的角色。

解

确保管理数据库中至少存在一个用户。如果管理数据库中没有用户，请添加用户。然后升级到MongoDB 2.6。最后，升级用户权限模型。请参阅将 MongoDB升级到2.6。

重要

在升级授权模型之前，您应该首先将MongoDB二进制文件升级到2.6。对于分片群集，请确保所有群集组件均为2.6。如果任何数据库中都有用户，则在升级MongoDB二进制文件之前，请确保数据库中至少有一个admin具有该角色的用户。userAdminAnyDatabase

也可以看看

安全改进

SSL证书主机名验证¶

描述

现在，SSL证书验证将检查“公用名”（CN）和“使用者备用名”（SAN）字段，以确保CN该SAN条目或其中之一与服务器的主机名匹配。因此，如果您当前使用SSL，并且当前SSL证书的或任何条目都不与主机名匹配，则升级到2.6版将导致SSL连接失败。CNSAN

解

为了允许继续使用这些证书，MongoDB提供了该allowInvalidCertificates设置。该设置可用于：

mongod并mongos绕过群集中其他服务器上SSL证书的验证。
mongo外壳程序，支持SSL的MongoDB工具和C ++驱动程序绕过服务器证书的验证。

使用allowInvalidCertificates设置时，MongoDB会记录使用无效证书的警告。

警告

该allowInvalidCertificates设置会绕过其他证书验证，例如检查过期和有效签名。

`2dsphere`索引版本2¶

描述

MongoDB 2.6引入了2dsphere索引的版本2 。如果文档缺少2dsphere 索引字段（或者该字段是null或为空数组），则MongoDB不会将文档条目添加到2dsphere索引中。对于插入，MongoDB插入文档但不添加到 2dsphere索引中。

以前的版本不会在2dsphere 索引字段为a null或为空数组的情况下插入文档。对于缺少2dsphere索引字段的文档，以前的版本将插入文档并为其建立索引。

解

若要还原为旧行为，请使用创建2dsphere索引以创建版本1索引。但是，版本1索引不能使用新的GeoJSON几何。

{
"2dsphereIndexVersion" : 1 }

也可以看看

版本号

日志消息¶

时间戳格式更改¶

描述: 现在，每条消息都以“ 时间格式更改”中给出的时间戳格式开始。以前的版本使用该ctime格式。
解: MongoDB中增加了一个新的选择--timeStampFormat，它支持时间戳格式ctime， iso8601-utc和iso8601-local（新的默认值）。

包配置更改¶

`bindIp`RPM / DEB软件包的默认值¶

描述: 在RPM官方MongoDB的包（红帽，CentOS的，Fedora的Linux和衍生品）和DEB（Debian的，Ubuntu和衍生品），默认bindIp值重视的MongoDB组件localhost接口只。这些软件包在默认配置文件（即/etc/mongod.conf。）中设置了此默认值。
解: 如果您使用这些软件包之一并且尚未修改默认 /etc/mongod.conf文件，则需要bindIp 在升级之前或升级过程中进行设置。

bindIp其他任何官方MongoDB软件包中均没有默认设置。

SNMP更改¶

描述

MongoDB的IANA企业标识符从37601更改为34601。
MongoDB将MIB字段名称更改globalopcounts为 globalOpcounts。

解

SNMP监视的用户必须将其SNMP配置（即MIB）从37601修改为34601。
更新引用globalopcounts到globalOpcounts。

删除方法签名更改¶

描述: db.collection.remove()需要查询文档作为参数。在以前的版本中，没有查询文档的方法调用会删除集合中的所有文档。
解: 对于db.collection.remove()没有查询文档的现有调用，请修改这些调用以包括一个空文档 db.collection.remove({})。

更新运算符语法验证¶

描述

更新运算符（例如$ set）必须指定一个非空的操作数表达式。例如，以下表达式现在无效：
复制
```
{ $set: { } }
```
更新运算符（例如$ set）不能在更新语句中重复。例如，以下表达式无效：
复制
```
{ $set: { a: 5 }, $set: { b: 5 } }
```

更新强制字段名称限制¶

描述

更新不能使用更新运算符（例如$ set）来定位具有空字段名称（即""）的字段。
更新不再支持保存包含点（.）或以美元符号（$）开头的字段名称的字段名称。

解

对于具有空名称字段的现有文档""，请替换整个文档。请参阅db.collection.update() 和db.collection.save()了解有关替换现有文档的详细信息。
对于具有名称包含点（.）的字段的现有文档，请替换整个文档或unset该字段。要查找名称中包含点的字段，请运行 db.upgradeCheckAllDBs（）。
对于具有名称以美元符号（$）开头的字段的现有文档，unset或rename这些字段。要查找名称以美元符号开头的字段，请运行db.upgradeCheckAllDBs（）。

有关写操作协议的更改，请参阅“ 新写操作协议”；有关插入和更新操作的更改，请参见“ 插入和更新改进 ”。还请考虑的文档。Restrictions on Field Names

查询和排序的变化¶

强制字段名称限制¶

描述: 查询不能在名称以美元符号（$）开头的字段上指定条件。
解: Unset或rename名称以美元符号（$）开头的现有字段。运行 db.upgradeCheckAllDBs（）以查找名称以美元符号开头的字段。

稀疏索引和不完整的结果¶

描述

如果稀疏索引导致查询和排序操作的结果集不完整，除非hint()明确指定索引，否则MongoDB将不会使用该索引。

例如，除非明确提示，查询将不再在字段上使用稀疏索引。{ x: { $exists: false } }x

解

要覆盖使用稀疏索引并返回不完整结果的行为，请使用显式指定索引 hint()。

有关详细说明新行为的示例，请参见集合上的稀疏索引无法返回完整结果。

`sort()`规范值¶

描述

该sort()方法仅接受以下排序键值：

1 为字段指定升序，
-1 指定字段的降序，或者
$meta 用于指定按文本搜索得分排序的表达式。

任何其他值都将导致错误。

以前的版本也接受要么true或false升序。

解

更新排序关键字值在使用true或false到1。

`skip()`和`_id`查询¶

描述

_id场上的平等比赛服从skip()。

skip()在_id字段上执行相等匹配时，将忽略以前的版本。

`explain()`保留查询计划缓存¶

描述

explain()不再清除为该查询形状缓存的查询计划。

在以前的版本中，explain()将具有清除该查询形状的查询计划缓存的副作用。

也可以看看

该PlanCache()参考。

地理空间的变化¶

`$maxDistance`变更¶

描述

对于$nearGeoJSON数据查询，如果查询指定$maxDistance，则$maxDistance必须在$near文档中。

在以前的版本中，$maxDistance可以在$near文档内部或外部。
$maxDistance 必须为正值。

解

更新任何现有的

MongoDB 中文手册

MongoDB 2.6中的兼容性更改

指数的变化¶

强制索引键长度限制¶

指数技术指标验证字段名称¶

ensureIndex与现有索引¶

Write方法致谢¶

db.collection.aggregate()变更¶

写关注验证¶

安全性更改¶

新的授权模型¶

SSL证书主机名验证¶

2dsphere索引版本2¶

日志消息¶

时间戳格式更改¶

包配置更改¶

bindIpRPM / DEB软件包的默认值¶

SNMP更改¶

删除方法签名更改¶

更新运算符语法验证¶

更新强制字段名称限制¶

查询和排序的变化¶

强制字段名称限制¶

稀疏索引和不完整的结果¶

sort()规范值¶

skip()和_id查询¶

explain()保留查询计划缓存¶

地理空间的变化¶

$maxDistance变更¶

`ensureIndex`与现有索引¶

`db.collection.aggregate()`变更¶

`2dsphere`索引版本2¶

`bindIp`RPM / DEB软件包的默认值¶

`sort()`规范值¶

`skip()`和`_id`查询¶

`explain()`保留查询计划缓存¶

`$maxDistance`变更¶