读关注 (read concern)

读关注选项

对于不在多文档事务中的操作，您可以将 readConcern 级别指定为支持读关注的命令和方法的选项：

readConcern: { level: <level> }

要为 mongosh 方法 db.collection.find() 指定读关注级别，请使用 cursor.readConcern() 方法：

db.collection.find().readConcern(<level>)

事务和可用的读关注

对于多文档事务，请在ACID 事务级别而不是单个操作级别设立读关注（read concern）。事务操作使用事务级读关注（read concern）。在集合和数据库级别设立的读关注在ACID 事务中将被忽略。如果您显式设立事务级别的读关注（read concern），则也会忽略客户端级别的读关注（read concern）。

您可以在事务开始时设置读关注：

• 多文档事务支持以下读关注（read concern）级别：

  • "local"

  • "majority"

  • "snapshot"

• 归属多文档事务的写命令可以支持事务级读关注。

• 您可以在事务中创建集合和索引。如果显式创建集合或索引，则事务必须使用读关注 "local"。如果隐式创建集合，则可以使用任何可用于事务的读关注。

如果在事务开始时未指定，则事务将使用会话级读关注，如果未设置，则使用客户端级读关注。

更多信息，请参阅事务读关注。

因果一致的会话和可用的读关注

对于因果一致会话中的操作，可以使用"local" 、"majority" 和"snapshot" 级别。为保证因果一致性，请使用"majority" 。有关详细信息，请参阅因果一致性。

支持读关注的操作

以下操作支持读关注：

如果以下写入操作是多文档事务的一部分，则也可以接受读关注：

local 数据库不支持读关注

本地数据库不支持读关注。 MongoDB默默地忽略对本地数据库中集合操作的任何配置的读关注（read concern）。

读取自己的写入

如果写入请求确认，您可以使用因果一致的会话来读取您自己的写入。

实时顺序

与"majority" 写关注（write concern）结合， 读关注（read"linearizable" concern）使多个线程能够对单个文档执行读取和写入，就像单个线程实时执行这些操作一样。这些读取和写入的相应安排被认为是可线性化的。

性能比较

与 "majority" 不同，"linearizable"读关注（read concern）与从节点(secondary node from replica set)成员确认该读操作从主节点读取，该主节点 (primary node in the replica set)能够使用 { w: "majority" }写关注（write concern）确认写入。 [4] 具有线性化读关注（read concern）的读取可能比具有 "majority" 或 "local" 读关注的读取慢得多。

如果大多数数据承载成员不可用，请始终将 maxTimeMS 与线性化读关注（read concern）一起使用。 maxTimeMS 确保操作在无法满足读关注（read concern）时返回错误，而不是无限期阻塞。

例如：

db.restaurants.find( { _id: 5 } ).readConcern("linearizable").maxTimeMS(10000)
db.runCommand( {
     find: "restaurants",
     filter: { _id: 5 },
     readConcern: { level: "linearizable" },
     maxTimeMS: 10000
} )

读操作和 afterClusterTime

MongoDB支持因果一致的会话。对于因果一致会话中的读操作，驱动程序会自动设立 afterClusterTime读关注（read concern）选项。

要满足 afterClusterTime值为T mongodTT的读取请求， 必须在其oplog到达时间mongod 之后执行该请求。如果其oplog尚未到达时间 ，则 将等待为该请求提供服务。

具有指定afterClusterTime 的读取操作会返回同时满足读关注（read concern）级别要求和指定 afterClusterTime要求的数据。

对于与因果一致性会话无关联的读操作，未设置 afterClusterTime。

读关注来源

MongoDB跟踪读关注（read concern）provenance ，它表示读关注（read concern）的来源。provenance 值显示在 指标、读关注（readgetLastError concern）错误对象和MongoDB日志中。

下表显示了可能的读关注 provenance 值及其重要性：