MongoDB 4.2发行说明_MonogDB 中文网

MongoDB 中文手册

参考 > 发行说明 > MongoDB 4.2发行说明

MongoDB 4.2发布于2019年8月13日¶

在本页面

次要发行版¶

4.2.6-2020年4月21日¶

4.2.6中修复的问题：

SERVER-45119：CollectionShardingState :: getCurrentShardVersionIfKnown返回集合版本而不是分片版本
SERVER-44892：getShardDistribution应该使用$ collStats agg阶段而不是collStats命令
SERVER-43848：使用快照读取在txn下查找/更新/删除不带分片键谓词的文档可能会丢失
SERVER-42827：如果至少一个分片返回OK，而其他分片返回CannotImplicitlyCreateCollection，则允许会话集合返回OK以创建索引
SERVER-40805：在日志文件中指出重新计划的原因
SERVER-45389：添加指标，以跟踪分片索引不一致的频率
SERVER-44689：为用户请求中的聚合阶段的每次使用添加serverStatus计数器
所有JIRA问题均已在4.2.6中关闭
4.2.6变更日志

4.2.5-2020年3月26日¶

注意

由于在发行过程中遇到问题，因此跳过了版本4.2.4的发行。但是，4.2.5版本包含4.2.4中所做的修复。

4.2.5中修复的问题：

SERVER-45770：添加到日志文件中有关“ moveChunk.to”的信息
所有JIRA问题均已在4.2.5中关闭
4.2.5变更日志

4.2.4中修复的问题：

SERVER-44915：扩展$ indexStats输出以包括完整的索引选项和分片名称
SERVER-46121：更改taskExecutorPoolSize后mongos崩溃并显示不变错误
SERVER-45137：以高收集率在Top :: record中增加内存分配可创建和删除
SERVER-44904：启动恢复在重建未完成的索引时不应删除损坏的文档
SERVER-44260：如果所有提交点都被保留，则事务可能与会话上的先前事务冲突
SERVER-35050：不要由于负文档计数而中止集合克隆
SERVER-39112：主排水模式可能会不必要地变慢
所有JIRA问题均已在4.2.4中解决
4.2.4变更日志

4.2.3-2020年1月27日¶

已解决的问题：

SERVER-42565：聚合和查找命令对丢失的字段进行不同的排序'
SERVER-44174：$ push和$ addToSet应该限制内存使用
SERVER-40435：一个clearJumboFlag命令来清除巨型标志
SERVER-45270：增加了慢速DNS的漏洞
TOOLS-1952：在WiredTiger节点上运行时，默认情况下使用–forceTableScan
工具2453：索引键未正确转义
SERVER-45396：使用splithorizon修复isMaster响应中的“ me”字段
SERVER-45309：确保绑定凭据的生存期比LDAP操作的生存期长
WT-5120：对帐未释放逐出生成时，检查点挂起
所有JIRA问题均已在4.2.3中解决
4.2.3变更日志

4.2.2-2019年12月9日¶

已解决的问题：

SERVER-31083：允许将主分片传递给新数据库的“ enableSharding”命令
SERVER-33272：DatabaseHolder :: close（）函数不再需要全局写锁，dropDatabase命令也不需要
SERVER-44050：沿着“哈希”索引键路径的数组未正确拒绝
SERVER-43882：为启动恢复构建索引在产生其光标之后使用未拥有的RecordData
SERVER-44617：当捕获组之一与输入不匹配但模式匹配时，$ regexFind崩溃
SERVER-44721：Shell KMS AWS支持无法解密响应
SERVER-43860：$ merge中的管道样式更新可能会产生意外的结果
WT-4961：具有缓存溢出的检查点必须保留读取历史记录
所有JIRA问题均已在4.2.2中关闭
4.2.2变更日志

4.2.1-2019年10月18日¶

已解决的问题：

SERVER-37768：平台支持：添加社区和企业Debian 10 x64
SERVER-37772：平台支持：添加社区和企业RHEL 8 x64
SERVER-41506：跟踪与调用选举的节点关联的度量
SERVER-41499：跟踪在serverStatus中出于每种原因调用的选举数量
SERVER-42518：当查询路径具有多个后续数组索引时，通配符索引计划会丢失结果
SERVER-42856：带有写操作的事务可以发送到错误的分片
所有JIRA问题均已在4.2.1中解决
4.2.1变更日志

分布式事务¶

分布式事务和多文档事务

从MongoDB 4.2开始，这两个术语是同义词。分布式事务是指分片群集和副本集上的多文档事务。从MongoDB 4.2开始，多文档事务（无论是在分片群集或副本集上）也称为分布式事务。

在版本4.2中，MongoDB引入了分布式事务。分布式交易：

增加了对分片群集上多文档事务的支持。
- 4.2分片群集的所有成员必须具有 featureCompatibilityVersion为4.2。
- 客户端必须使用为MongoDB 4.2更新的MongoDB驱动程序
包含对副本集上事务的现有支持。
- 4.2复制集的所有成员必须具有的 featureCompatibilityVersion为4.2。
- 客户端必须使用为MongoDB 4.2更新的MongoDB驱动程序
删除事务的总大小限制为16MB。在版本4.2中，MongoDB根据需要创建尽可能多的oplog条目（16MB 每个条目的最大大小）以封装事务中的所有写操作。在MongoDB 4.0中，MongoDB为事务中的所有写操作创建单个条目，从而对事务施加16MB的总大小限制。
将事务支持扩展到其辅助成员使用内存存储引擎的部署。也就是说，事务可用于使用WiredTiger存储引擎作为主要成员，使用WiredTiger或内存中存储引擎作为辅助成员的部署。在MongoDB 4.0中，事务仅可用于使用WiredTiger存储引擎的部署。

有关更多信息，请参见事务。

也可以看看

4.2交易兼容性更改

删除了MMAPv1存储引擎¶

MongoDB 4.2删除了不赞成使用的MMAPv1存储引擎。

如果您的4.0部署使用MMAPv1，则必须在升级到MongoDB 4.2之前将部署更改为 WiredTiger Storage Engine。有关详细信息，请参见：

MMAPv1特定配置选项¶

MongoDB删除了以下特定于MMAPv1的配置选项：

删除配置文件设置	删除的命令行选项
`storage.mmapv1.journal.commitIntervalMs`
`storage.mmapv1.journal.debugFlags`	`mongod --journalOptions`
`storage.mmapv1.nsSize`	`mongod --nssize`
`storage.mmapv1.preallocDataFiles`	`mongod --noprealloc`
`storage.mmapv1.quota.enforced`	`mongod --quota`
`storage.mmapv1.quota.maxFilesPerDB`	`mongod --quotaFiles`
`storage.mmapv1.smallFiles`	`mongod --smallfiles`
`storage.repairPath`	`mongod --repairpath`
`replication.secondaryIndexPrefetch`	`mongod --replIndexPrefetch`

注意

从4.2版开始，MongoDB进程将不会以这些选项开头。如果使用WiredTiger部署，请删除所有MMAPv1特定的配置选项。

MMAPv1特定参数¶

MongoDB删除以下MMAPv1参数：

newCollectionsUsePowerOf2Sizes
replIndexPrefetch

MMAPv1特定命令¶

MongoDB删除MMAPv1特定touch命令。

MMAPv1二进制，命令和方法的特定选项¶

MongoDB删除了MMAPv1特定的选项：

noPadding和usePowerOf2Sizes为collMod
verbose 对于 collStats
flags 对于 create
paddingFactor，paddingBytes，preservePadding对 db.createCollection()方法和compact 命令。
repair 对于 mongodump

删除命令和方法¶

删除的命令	删除方法	笔记
`group`	`db.collection.group()`	而是`db.collection.aggregate()`与`$group`舞台一起使用。
`eval`		MongoDB 4.2 `mongo`Shell方法 `db.eval()`，`db.collection.copyTo()`仅在连接到MongoDB 4.0或更早版本时才能运行。
`copydb`		仅当连接到MongoDB 4.0或更早版本时，相应的`mongo`shell帮助 `db.copyDatabase()`器才能运行。或者，用户可以使用`mongodump`和使用驱动程序`mongorestore`（请参阅复制/克隆数据库）或编写脚本。
`clone`		仅当连接到MongoDB 4.0或更早版本时，相应的`mongo`shell帮助 `db.cloneDatabase()`器才能运行。或者，用户可以使用`mongodump`和使用驱动程序`mongorestore`（请参阅复制/克隆数据库）或编写脚本。
`geoNear`		而是`db.collection.aggregate()`与`$geoNear`舞台一起使用。有关更多信息，请参阅删除对geoNear命令的支持。
`parallelCollectionScan`
`repairDatabase`	`db.repairDatabase()`	有关更多信息，请参见删除对repairDatabase命令的支持。
`getPrevError`	`db.getPrevError()`

删除`maxScan`选项¶

MongoDB删除了maxScan该 find命令和mongoshell助手的不推荐使用的选项cursor.maxScan()。请使用命令maxTimeMS选项 find或帮助程序cursor.maxTimeMS()。

MongoDB的驱动程序¶

以下驱动程序与MongoDB 4.2 具有功能兼容[1]：

C 1.15.0 C＃2.9.0 去1.1	Java 3.11.0 节点3.3.0 Perl 2.2.0	的Python 3.9.0 Ruby 2.10.0 Scala 2.7.0

[1]	有关支持客户端字段级加密的官方4.2兼容驱动程序的完整列表，请参见驱动程序兼容性表。

分片群集¶

可变分片键值¶

从MongoDB 4.2开始，除非分片键字段是不可变_id字段，否则您可以更新文档的分片键值。有关更新分片键的详细信息，请参阅“ 更改文档的分片键值”。

在MongoDB 4.2之前，文档的分片键字段值是不可变的。

备份¶

mongodump并且不能作为正在进行分片事务的4.2+分片群集的备份策略的一部分，因为使用创建的备份 不能保持跨分片事务的原子性保证。mongorestore mongodump

对于具有正在进行中的分片事务的4.2+分片群集，请使用以下协调的备份和还原过程之一，该过程 确实维护了跨分片事务的原子性保证：

平衡器状态和自动拆分¶

从MongoDB 4.2开始：

该balancerStart命令和 mongoShell帮助程序方法 sh.startBalancer()， sh.setBalancerState(true)还启用了分片群集的自动拆分。

要在启用平衡器时禁用自动拆分，可以使用sh.disableAutoSplit()。
该balancerStop命令和mongo 外壳帮助程序方法sh.stopBalancer()， sh.setBalancerState(false)还禁用分片群集的自动拆分。

要在禁用平衡器时启用自动拆分，可以使用sh.enableAutoSplit()。

该mongo方法 sh.enableBalancing(namespace)和 sh.disableBalancing(namespace)对自动分裂没有影响。

`mongos`连接池¶

从MongoDB 4.2开始，MongoDB将ShardingTaskExecutorPoolReplicaSetMatching确定mongos实例连接池的最小大小（在运行时可能变化）的参数添加到分片群集的每个成员。

默认情况下，对于分片群集中的每个副本集（即，分片副本集和配置服务器），mongos维护与每个辅助副本集的连接池至少等于其与主副本集的连接池的大小。

要进行修改，请参见ShardingTaskExecutorPoolReplicaSetMatching。

分片集合和替换文档¶

从MongoDB 4.2开始，

替换文档操作，例如db.collection.replaceOne()或db.collection.update（query， replace ，…），首先尝试使用查询过滤器来定位单个分片。如果该操作无法通过查询过滤器定位到单个分片，则它将尝试以替换文档定位。

在早期版本中，该操作尝试使用替换文档作为目标。
对于包含并在分片集合上的替换文档操作，必须在完整分片键上包含相等匹配项。upsert: truefilter

安全性改进¶

解决的常见漏洞和披露¶

MongoDB 4.2包含的修复程序可解决以下常见漏洞和披露（CVE）：

CVE-2019-2389（请参阅SERVER-40563）
CVE-2019-2386（请参阅SERVER-38984）

新`TLS`选项¶

MongoDB 4.2 TLS为mongod，mongos和 mongo shell添加了选项，以替换相应的 SSL选项（在4.2中已弃用）。新的TLS选项提供与不推荐使用的SSL选项相同的功能，因为MongoDB一直支持TLS 1.0和更高版本。

有关命令行TLS选项，请参阅mongod，mongos和 mongo Shell页面。
对于相应的mongod和mongos配置文件的选项，请参阅配置文件页面。
有关连接字符串tls选项，请参阅连接字符串页面。

小费

大多数新的TLS选项名称与选项名称相似SSL 。例如--tlsMode代替 --sslMode。例外是：

也可以看看

新的tlsClusterCAFile选项

已过时`SSL`选项¶

MongoDB的4.2弃用所述SSL用于选择的mongod，所述mongos和蒙戈壳以及相应 net.ssl选项配置文件的选项。

请改用新的TLS选项。

新`tls`参数¶

新参数	描述
`tlsWithholdClientCertificate`	可用于`mongod`和`mongos`，参数可以被设置为`true`从发送其停止实例`TLS`证书发起与其他群集内通信时`mongod`或 `mongos`实例。有关详细信息，请参见 `tlsWithholdClientCertificate`。
`tlsX509ClusterAuthDNOverride`	可用于`mongod`和`mongos`，该参数可以设置为备用证书`DN`以用于x.509成员身份验证。有关详细信息，请参见`tlsX509ClusterAuthDNOverride`。您可以使用此参数将证书滚动更新为包含新`DN`值的新证书。请参阅滚动更新包含新DN的x.509群集证书。

新`tlsClusterCAFile`选项¶

MongoDB的4.2增加了 --tlsClusterCAFile选项/ net.tls.clusterCAFile为 mongod和mongos，其中指定 .pem用于从客户端建立连接验证TLS证书文件。这使您可以使用单独的证书颁发机构来验证TLS握手的客户端到服务器以及服务器到客户端部分。

也可以看看

新的TLS选项

转发保密¶

从Linux上的4.2版本开始：

如果平台的OpenSSL支持针对椭圆曲线Diffie-Hellman的自动曲线选择，则MongoDB将启用对临时椭圆曲线Diffie-Hellman（ECDHE）的支持。
如果平台的OpenSSL不支持针对椭圆曲线Diffie-Hellman的自动曲线选择，则MongoDB尝试使用prime256v1命名曲线来启用ECDHE支持。
如果启用了对ECDHE的支持，则如果未明确启用临时Diffie-Hellman（DHE），则MongoDB会尝试启用对临时Diffie-Hellman（DHE）的支持。

在MongoDB的早期版本（3.6.14+和4.0.3+）中，如果在编译期间Linux平台的OpenSSL支持ECDH参数的自动曲线选择，则MongoDB可以支持临时椭圆曲线Diffie-Hellman（ECDHE）。

在Windows和macOS上，MongoDB对ECDHE和DH的支持与早期版本保持不变。也就是说，通过使用平台各自的本机TLS / SSL OS库隐含了支持。

有关更多信息，请参见转发保密。

`passwordPrompt()`¶

从mongoShell的4.2版本开始，您可以将该passwordPrompt()方法与各种用户身份验证/管理方法/命令结合使用以提示输入密码，而不是直接在方法/命令调用中指定密码。但是，您仍然可以像在早期版本的mongoShell中一样直接指定密码。

例如：

复制

db.createUser( {
   user:"user123",
   pwd: passwordPrompt(),   // Instead of specifying the password in cleartext
   roles:[ "readWrite" ]
} )

密钥文件格式更改为YAML ¶

从MongoDB 4.2开始，用于内部成员身份验证的密钥文件使用YAML格式，以允许密钥文件中包含多个密钥。YAML格式接受以下内容：

单个键字符串（与早期版本相同），
多个键字符串（每个字符串必须用引号引起来），或者
键串的顺序。

YAML格式与使用文本文件格式的现有单键密钥文件兼容。

新格式允许滚动升级密钥而无需停机。见旋转键副本集和旋转键分片集群。

`libldap`和`libldap_r`¶

对于链接到的MongoDB 4.2（和4.0.9）企业二进制文件 libldap（例如在RHEL上运行时），对的访问 libldap是同步的，这会导致性能/延迟成本。

对于链接到的MongoDB 4.2（和4.0.9）企业二进制文件，与 libldap_r早期MongoDB版本相比，行为没有变化。

加密存储引擎¶

对于配置了密码的加密存储引擎AES256-GCM：

从热备份还原

从4.2开始，如果您从通过“热”备份（即mongod正在运行）获取的文件中还原，MongoDB可以在启动时检测“脏”密钥并自动翻转数据库密钥以避免IV（初始化向量）重用。
从冷备份还原

但是，如果您从通过“冷”备份获取的文件中恢复（即mongod未运行），则MongoDB无法在启动时检测到“脏”密钥，并且IV的重用会使机密性和完整性保证无效。

从4.2开始，为避免从冷文件系统快照还原后重新使用密钥，MongoDB添加了一个新的命令行选项--eseDatabaseKeyRollover。使用该--eseDatabaseKeyRollover选项启动后，mongod 实例将滚动使用AES256-GCM密码配置的数据库密钥并退出。

有关更多信息，请参阅加密的存储引擎和--eseDatabaseKeyRollover。

客户端字段级加密¶

官方

MongoDB 中文手册

MongoDB 4.2发行说明

MongoDB 4.2发布于2019年8月13日¶

次要发行版¶

4.2.6-2020年4月21日¶

4.2.5-2020年3月26日¶

4.2.3-2020年1月27日¶

4.2.2-2019年12月9日¶

4.2.1-2019年10月18日¶

分布式事务¶

删除了MMAPv1存储引擎¶

MMAPv1特定配置选项¶

MMAPv1特定参数¶

MMAPv1特定命令¶

MMAPv1二进制，命令和方法的特定选项¶

删除命令和方法¶

删除maxScan选项¶

MongoDB的驱动程序¶

分片群集¶

可变分片键值¶

备份¶

平衡器状态和自动拆分¶

mongos连接池¶

分片集合和替换文档¶

安全性改进¶

解决的常见漏洞和披露¶

新TLS选项¶

已过时SSL选项¶

新tls参数¶

新tlsClusterCAFile选项¶

转发保密¶

passwordPrompt()¶

密钥文件格式更改为YAML ¶

libldap和libldap_r¶

加密存储引擎¶

客户端字段级加密¶

删除`maxScan`选项¶

`mongos`连接池¶

新`TLS`选项¶

已过时`SSL`选项¶

新`tls`参数¶

新`tlsClusterCAFile`选项¶

`passwordPrompt()`¶

`libldap`和`libldap_r`¶