读关注 (read concern)

读关注选项

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

readConcern: { level: <level> }

To specify the read concern level for mongosh method db.collection.find(), use the cursor.readConcern() method:

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

事务和可用的读关注

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

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

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

  • "local"

  • "majority"

  • "snapshot"

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

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

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

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

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

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

支持读关注的操作

以下操作支持读关注：

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

local 数据库不支持读关注

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

读取自己的写入

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

实时顺序

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

性能比较

Unlike "majority", "linearizable" read concern confirms with secondary members that the read operation reads from a primary capable of confirming writes with { w: "majority" } write concern. [4] Reads with linearizable read concern may be significantly slower than reads with "majority" or "local" read concerns.

如果大多数数据承载节点不可用，请始终将 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 的读取请求，mongod 必须在其oplog到达时间 T 之后执行该请求。如果其oplog尚未到达时间 T，则 mongod 将等待为该请求提供服务。

Read operations with a specified afterClusterTime return data that meets both the read concern level requirement and the specified afterClusterTime requirement.

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

读关注来源

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

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