可重试读取

在本页面
​前提条件​
​启用可重试读取​
​可重试的读取操作​
​行为​
可重试读取允许MongoDB驱动程序在遇到某些网络或服务器错误时，可以一次自动重试某些读取操作。
前提条件
最小驱动程序版本
​ 官方MongoDB驱动兼容MongoDB服务器4.2和以后支持重试读取。
​ 有关官方MongoDB驱动程序的更多信息，请参阅 MongoDB驱动程序。
最低服务器版本
​ 如果连接到MongoDB Server 3.6或更高版本，驱动程序只能重试读取操作。
启用可重试读取
官方MongoDB驱动程序兼容MongoDB服务器4.2和以后默认启用可重试读取。要显式禁用可重试读取，请在部署的连接字符串中中指定retryReads=false。
在mongoshell不支持重试读取。
可重试的读取操作
MongoDB驱动程序支持重试以下读取操作。列表引用了每个方法的通用描述。对于特定的语法和用法，请遵循该方法的驱动程序文档。
方法
内容描述
Collection.aggregate Collection.count Collection.countDocuments Collection.distinct Collection.estimatedDocumentCount Collection.find Database.aggregate
CRUD API读取操作.
对于Collection.aggregate和Database.aggregate，驱动程序只能重试不包括写阶段的聚合管道，如$out或$merge。
Collection.watch Database.watch MongoClient.watch
更改流操作
MongoClient.listDatabases Database.listCollections Collection.listIndexes
枚举操作
GridFS操作由Collection.find （ 例如GridFSBucket.openDownloadStream）支持
GridFS文件下载操作
MongoDB驱动程序可能包括对其他操作的可重试支持，比如帮助方法或包装可重试读操作的方法。根据驱动程序文档 确定方法是否显式支持可重试读取。
也可以看看:
可重试读规范:支持的读取操作.
不支持的读取操作
以下操作不支持可重试的读取：
​db.collection.mapReduce()​
​getMore​
传递给通用Database.runCommand帮助器的任何读命令，它与读或写命令无关。
行为
持久性网络错误
MongoDB可重试读取只做一次重试尝试。这有助于解决暂时的网络错误或复制集选举，但不能解决持久的网络错误。
故障转移期间
在重试读取操作之前，驱动程序使用read命令的原始读取首选项执行服务器选择。如果驱动程序不能选择使用原始读取首选项进行重试的服务器，则驱动程序返回原始错误。
驱动程序在执行服务器选择之前等待serverSelectionTimeoutMS毫秒。可重试读取不会处理在等待serverSelectionTimeoutMS后不存在合格服务器的实例。
译者：杨帅
校对：杨帅

方法	内容描述
Collection.aggregate Collection.count Collection.countDocuments Collection.distinct Collection.estimatedDocumentCount Collection.find Database.aggregate	CRUD API读取操作.

最近更新 1yr ago

Collection.watch Database.watch MongoClient.watch	更改流操作
MongoClient.listDatabases Database.listCollections Collection.listIndexes	枚举操作
GridFS操作由`Collection.find` （例如`GridFSBucket.openDownloadStream`）支持	GridFS文件下载操作