读取偏好

读取偏好模式

下表给出读取偏好模式的简要摘要：

有关读取偏好模式的详细说明，请参阅读取偏好模式。

行为

• 除 primary 之外的所有读取偏好模式都可能返回过时数据，因为从节点在异步过程中从主节点复制操作。[1] 如果选择使用非 primary 模式，请确保应用程序可以容忍过时数据。

• 读取偏好不影响数据的可见性；即客户端可以在写入结果被确认或传播到大多数副本集节点之前看到写入结果。有关详细信息，请参阅读取隔离、一致性和新近度。

• 读取偏好不会影响因果一致性。因果一致性会话为具有 "majority" 读关注的读取操作以及具有 "majority" 写关注的写入操作提供的因果一致性保证适用于 MongoDB 部署的所有节点。

读取偏好模式

primary

所有读取操作仅使用当前副本集主节点。[1] 这是默认的读取模式。如果主节点不可用，则读取操作会产生错误或抛出异常。

primary 读取偏好模式与使用标签集列表或 maxStalenessSeconds 的读取偏好模式不兼容。如果指定标签集列表或带有 primary 的 maxStalenessSeconds 值，则驱动程序将产生错误。

包含读取操作的分布式事务必须使用读取偏好 primary。给定事务中的所有操作必须路由到同一节点。

primaryPreferred

在大多数情况下，操作都是从副本集的主节点读取。但是，如果主节点不可用（例如在故障转移期间），则操作将从满足读取偏好的 maxStalenessSeconds 和标签集列表的从节点读取。

当 primaryPreferred 读取偏好包含 maxStalenessSeconds 值且没有可供读取的主节点时，客户端会通过将从节点的最后一次写入与执行最近一次写入的从节点进行比较，从而估计每个从节点的陈旧程度。然后，客户端会将读取操作定向到估计延迟小于或等于 maxStalenessSeconds 的从节点。

当读取偏好包含标签集列表（标签集数组）时且没有可读取的主节点时，客户端会尝试查找具有匹配标签的从节点（按顺序尝试标签集，直到找到匹配项）。如果找到匹配的从节点，则客户端会从最近的匹配从节点群组中随机选择一个从节点。如果从节点没有匹配的标签，读取操作就会出错。

当读取偏好包含 maxStalenessSeconds 值和标签集列表时，客户端首先按过时程度筛选，然后按指定标签筛选。

使用 primaryPreferred 模式进行读取操作可能会返回过时数据。使用 maxStalenessSeconds 选项避免从客户端估计过于陈旧的从节点读取数据。

注意

读取优先级 primaryPreferred 支持分片集群上的对冲读。

secondary

操作只能从副本集的从节点读取。如果没有可用的从节点，则此读取操作会出现错误或异常。

大多数副本集至少有一个从节点，但在某些情况下可能没有可用的从节点。例如，如果节点处于恢复状态或不可用状态，则由主节点、从节点和仲裁节点构成的副本集可能没有任何从节点。

当 secondary 读取偏好包含 maxStalenessSeconds 值时，客户端通过将从节点的最后一次写入与主节点进行比较来估计每个从节点的过时程度。然后，客户端会将读取操作定向到估计延迟小于或等于 maxStalenessSeconds 的从节点。如果没有主节点，客户端将使用最近写入的从节点进行比较。

当读取偏好包含标签集列表（标签集数组）时，客户端会尝试查找具有匹配标签的从节点成员（按顺序尝试标签集，直到找到匹配项）。如果找到匹配的从节点，则客户端会从最近的匹配从节点群组中随机选择一个从节点。如果从节点没有匹配的标签，读取操作就会出错。

当读取偏好包含 maxStalenessSeconds 值和标签集列表时，客户端首先按过时程度筛选，然后按指定标签筛选。

使用 secondary 模式进行读取操作可能会返回过时数据。使用 maxStalenessSeconds 选项避免从客户端估计过于陈旧的从节点读取数据。

注意

读取优先级 secondary 支持分片集群上的对冲读。

secondaryPreferred

操作通常从副本集的从节点成员读取数据。如果副本集只有一个主节点成员，并且没有其他成员，则操作将从主节点成员读取数据。

当 secondaryPreferred 读取偏好包含 maxStalenessSeconds 值时，客户端通过将从节点的最后一次写入与主节点进行比较来估计每个从节点的过时程度。然后，客户端会将读取操作定向到估计延迟小于或等于 maxStalenessSeconds 的从节点。如果没有主节点，客户端将使用最近写入的从节点进行比较。如果没有估计滞后小于或等于 maxStalenessSeconds 的从节点，则客户端会将读取操作定向到副本集的主节点。

当读取偏好包含标签集列表（标签集数组）时，客户端会尝试查找具有匹配标签的从节点成员（按顺序尝试标签集，直到找到匹配项）。如果找到匹配的从节点，则客户端会从最近的匹配从节点群组中随机选择一个从节点。如果不存在具备匹配标签的从节点，则客户端忽略标签并从主节点读取。

当读取偏好包含 maxStalenessSeconds 值和标签集列表时，客户端首先按过时程度筛选，然后按指定标签筛选。

使用 secondaryPreferred 模式进行读取操作可能会返回过时数据。使用 maxStalenessSeconds 选项避免从客户端估计过于陈旧的从节点读取数据。

注意

读取优先级 secondaryPreferred 支持分片集群上的对冲读。

nearest

驱动程序从网络延迟处于可接受延迟窗口内的节点读取数据。路由读取操作时，nearest 模式中的读取不考虑节点是主节点还是从节点：主节点和从节点均被同等对待。

设置此模式可最大限度地减少网络延迟对读取操作的影响，而不会优先考虑当前或过时的数据。

当读取偏好包含 maxStalenessSeconds 值时，客户端会通过将从节点的最后一次写入与主节点的最后一次写入（如果可用）进行比较来估计每个从节点的陈旧程度；或者，如果没有主节点，则会将其与执行最近一次写入的从节点进行比较。然后，客户端会过滤掉其估计延迟大于 maxStalenessSeconds 的所有从节点，并将此读取操作随机定向到网络延迟不超过可接受延迟窗口的其余节点（主节点或从节点）。

如果指定标签集列表，则客户端会尝试查找与指定标签集列表匹配的副本集节点，并将读取定向到最近的群组中的任意节点。

当读取偏好包含 maxStalenessSeconds 值和标签集列表时，客户端首先按过时程度筛选，然后按指定标签过滤。然后，客户端从剩余的 mongod 实例中，随机将读取定向到处于可接受延迟时间范围内的实例。读取偏好节点选择文档详细描述了该过程。

使用 nearest 模式进行读取操作可能会返回过时数据。使用 maxStalenessSeconds 选项避免从客户端估计过于陈旧的从节点读取数据。

注意

读取偏好 nearest 默认指定使用对冲读来处理分片集群上的读取操作。

配置读取偏好

使用 MongoDB 驱动程序时，您可以使用驱动程序的读取偏好 API 指定读取偏好。请参阅驱动程序 API 文档。您还可以在连接到副本集或分片集群时设置读取偏好（对冲读选项除外）。有关示例，请参阅连接字符串。

对于给定的读取偏好，MongoDB 驱动程序使用相同的节点选择逻辑。

使用 mongosh 时，请参阅 cursor.readPref() 和 Mongo.setReadPref()。

读取偏好和事务

包含读取操作的分布式事务必须使用读取偏好 primary。给定事务中的所有操作必须路由到同一节点。

其他注意事项

在聚合管道中使用 $merge 或 $out 阶段时，请考虑以下几点：

• 从 MongoDB 5.0 开始，如果集群中的所有节点都将 featureCompatibilityVersion 设置为 5.0 或更高，并且读取偏好允许辅助读取，则具有 $merge 阶段的管道可以在副本集辅助节点上运行。

  • $merge 和 $out 阶段在从节点上运行，但写入操作被发送到主节点。

  • 并非所有驱动程序版本都支持发送到辅助节点的 $merge 操作。有关详细信息，请参阅驱动程序文档。

• 在早期的 MongoDB 版本中，具有 $out 或 $merge 阶段的管道始终在主节点上运行，并且不考虑读取偏好。

对于 mapReduce 操作，只有不写入数据的“内联” mapReduce 操作支持读取偏好。否则，mapReduce 操作将在主节点上运行。