阅读偏好

读取首选项描述了 MongoDB 客户端如何将读取操作路由到副本集的节点。

默认情况下，应用程序将其读取操作定向到 副本集中的主节点。但是，客户端可以指定读取首选项以将读取操作发送到从节点。

阅读偏好包括阅读偏好模式以及可选的标签集列表、maxStalenessSeconds选项和 对冲读取选项。对冲读取选项可用于 MongoDB 4.4+ 分片集群，用于使用非primary读取首选项的读取。

下表列出了阅读偏好模式的简要总结：

NOTE

从 4.4 版本开始，非primary读取优先模式支持分片集群上的对冲读取。

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

提示

也可以看看：

• 阅读偏好标签集列表
• 阅读偏好maxStalenessSeconds
• 对冲读取

行为

• 所有阅读偏好模式除外primary可能会返回陈旧数据，因为从节点在异步过程中从主节点复制操作。 [ 1 ]如果您选择使用非primary 模式。
• 阅读偏好不影响数据的可见性；即客户端可以在写入结果被确认或传播到大多数副本集节点之前看到写入结果。有关详细信息，请参阅 读取隔离、一致性和新近度。
• 阅读偏好不影响 因果一致性。因果一致性会话为具有 读取安全的读取操作和具有写安全的写入操作 提供的 因果一致性保证适用于 MongoDB 部署的所有成员。"majority""majority"

阅读偏好模式

• primary

  所有读取操作仅使用当前副本集 primary。[ 1 ]这是默认的阅读模式。如果主数据库不可用，读取操作会产生错误或抛出异常。这primary读取首选项模式与使用标记集列表或maxStalenessSeconds的读取首选项模式不兼容。如果您指定标记集列表或一个maxStalenessSeconds值primary，驱动程序将产生一个错误。包含读取操作的多文档事务必须使用读取首选项primary. 给定事务中的所有操作必须路由到同一成节点。

• primaryPreferred

  当 primaryPreferred 读取首选项包含 maxStalenessSeconds 值并且没有可从中读取的主节点数据时，客户端通过将次要数据的最后一次写入与次要数据的最近一次写入进行比较来估计每个次要数据的陈旧程度。 客户端然后将读取操作定向到一个其估计滞后小于或等于 maxStalenessSeconds 的从节点。然后客户端将读取操作定向到估计滞后小于或等于 的从节点maxStalenessSeconds。当读取首选项包括标签集列表（标签集数组）并且没有可从中读取的主节点时，客户端会尝试查找具有匹配标签的从节点（按顺序尝试标签集直到找到匹配项）。如果找到匹配的从节点，客户端会从最近的匹配从节点组中随机选择一个从节点。如果没有从节点具有匹配的标签，则读取操作会产生错误。当读取首选项包括一个maxStalenessSeconds值 和一个标签集列表时，客户端首先按陈旧性过滤，然后按指定的标签过滤。使用读取操作primaryPreferred模式可能会返回陈旧的数据。使用该 maxStalenessSeconds选项可以避免从客户端读取过时的次级数据。笔记从 4.4 版开始，primaryPreferred支持 分片集群上的对冲读取。

• secondary

  读取操作只从集合的从节点操作。如果没有从节点可用，则此读取操作会产生错误或异常。大多数副本集至少有一个从节点，但在某些情况下可能没有可用的从节点。例如，如果节点处于恢复状态或不可用，则具有主节点、从节点和 仲裁节点的副本集可能没有任何可用的从节点。当secondary读取首选项包括一个maxStalenessSeconds 值，客户端通过比较从节点最后一次写入与主节点写入来估计每个从节点陈旧程度。然后，客户端将读取操作定向到估计滞后小于或等于 的从节点maxStalenessSeconds。如果没有主节点，客户端使用具有最近写入的从节点进行比较。当读取首选项包含标签集列表（标签集数组）时，客户端会尝试查找具有匹配标签的从节点（按顺序尝试标签集，直到找到匹配项）。如果找到匹配的从节点，客户端会从最近的匹配从节点组中随机选择一个从节点。如果没有从节点具有匹配的标签，则读取操作会产生错误。当读取首选项包括一个maxStalenessSeconds值 和一个标签集列表时，客户端首先按陈旧性过滤，然后按指定的标签过滤。使用读取操作secondary模式可能会返回陈旧的数据。使用该 maxStalenessSeconds选项可以避免从客户端读取过时的次级数据。笔记从 4.4 版开始，secondary支持 分片集群上的对冲读取。

• secondaryPreferred

  在大多数情况下，操作从从节点读取，但在集合由单个 主节点（没有其他节点）组成的情况下，读取操作将使用副本集的主节点。当secondaryPreferred读取首选项包括一个maxStalenessSeconds 值，客户端通过比较从节点最后一次写入与主节点写入来估计每个从节点陈旧程度。然后，客户端将读取操作定向到估计滞后小于或等于的从节点maxStalenessSeconds。如果没有主节点，客户端使用具有最近写入的从节点进行比较。如果没有估计滞后小于或等于 的从节点maxStalenessSeconds，则客户端将读取操作定向到副本集的主节点。当读取首选项包含标签集列表（标签集数组）时，客户端会尝试查找具有匹配标签的从节点（按顺序尝试标签集，直到找到匹配项）。如果找到匹配的从节点，客户端会从最近的匹配从节点组中随机选择一个从节点。如果没有从节点具有匹配的标签，则客户端将忽略标签并从主节点读取。当读取首选项包括一个maxStalenessSeconds值 和一个标签集列表时，客户端首先按陈旧性过滤，然后按指定的标签过滤。使用读取操作secondaryPreferred模式可能会返回陈旧的数据。使用该 maxStalenessSeconds选项可以避免从客户端读取过时的次级数据。笔记从 4.4 版开始，secondaryPreferred支持 分片集群上的对冲读取。

• nearest

  驱动程序从其网络延迟落在可接受的延迟窗口内的节点读取。读入nearestmode 在路由读取操作时不考虑节点是主节点还是 从节点：主节点和从节点被同等对待。设置此模式可最大限度地减少网络延迟对读取操作的影响，而不优先考虑当前或过时的数据。当读取首选项包含maxStalenessSeconds 值时，客户端通过将从节点最后一次写入与主节点写入（如果可用）或如果没有主节点则与最近的写入进行比较来估计每个次要的陈旧程度。然后，客户端将过滤掉滞后大于估计值的从节点，并随机将读取定向到网络延迟落在可接受延迟窗口maxStalenessSeconds内的剩余节点（主节点或从节点） 。如果你指定了一个标签集列表，客户端会尝试找到一个与指定的标签集列表相匹配的副本集节点，并将读取定向到最近组中的任意节点。当读取首选项包括一个maxStalenessSeconds值 和一个标签集列表时，客户端首先按陈旧性过滤，然后按指定的标签过滤。从剩余的mongod实例中，客户端然后随机将读取定向到落在可接受的延迟窗口内的实例。阅读首选项节点选择 文档详细描述了该过程。使用读取操作nearest模式可能会返回陈旧的数据。使用该 maxStalenessSeconds选项可以避免从客户端读取过时的次级数据。笔记从 4.4 版本开始，读取首选项nearest，默认情况下，指定对分片集群上的读取使用对冲读取。

提示

也可以看看：

要了解特定阅读首选项设置的用例，请参阅阅读首选项用例。

配置阅读首选项

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

对于给定的读取首选项，MongoDB 驱动程序使用相同的 成员选择逻辑。

使用时mongosh，见 cursor.readPref()和Mongo.setReadPref()。

阅读偏好和交易

包含读取操作的多文档事务必须使用读取首选项primary. 给定事务中的所有操作必须路由到同一成员。

其他注意事项

对于包含或阶段的聚合管道操作，无论读取首选项设置如何，管道都在主节点上运行。$out$merge

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

← 写对副本集的关注阅读偏好标签集列表 →

原文链接 -https://docs.mongodb.com/manual/core/read-preference/

译者:陆文龙