读关注 (read concern)

读关注选项

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

readConcern: { level: <level> }

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

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

事务和可用的读关注

对于多文档事务，您可以在事务级别设置读关注，而不是在单个操作级别。事务中的操作将使用事务级读关注。在集合和数据库级别设置的任何读关注在事务中都会被忽略。如果显式指定了事务级读关注，则在事务内也会忽略客户端级读关注。

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

• 对于多文档事务，可以使用以下读关注级别：

  • "local"

  • "majority"

  • "snapshot"

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

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

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

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

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

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

支持读关注的操作

以下操作支持读关注：

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

local数据库不支持读关注

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

读取自己的写入

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

在 MongoDB 3.6 之前，为读取自己的写入，必须发出带 { w: "majority" } 写关注的写入操作，然后发出带 primary 读取偏好以及 "majority" 或 "linearizable" 读关注的读取操作。

实时顺序

与 "majority" 写关注结合，"linearizable" 读关注使多个线程能够对单个文档执行读写，就像单个线程实时执行这些操作一样；换言之，这些读写的相应计划表被认为是可线性化的。

性能比较

与 "majority" 不同，"linearizable" 读关注向从节点成员确认读取操作正在从能够使用 { w: "majority" } 写关注确认写操作的主节点成员进行读取。[4] 因此，具有可线性化读关注的读取可能比具有 "majority" 或 "local" 读关注的读取要慢得多。

始终将maxTimeMS与线性化读关注一起使用，以防大多数数据承载成员不可用。maxTimeMS确保操作不会无限期受阻，而是确保操作在无法满足读关注时返回错误。

例如：

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

读操作和 afterClusterTime

MongoDB 3.6 引入对因果一致会话的支持。对于与因果一致会话关联的读操作，MongoDB 3.6 引入 afterClusterTime 读关注选项，该选项由与因果一致会话关联的操作的驱动程序自动设置。

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

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

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

读关注来源

MongoDB 追踪读关注（read concern）provenance ，它表示特定读关注（read concern）的来源。您可能会看到 { getLastError指标、读关注（read concern）错误对象和 MongoDB 日志中显示provenance 。

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