阅读偏好

行为¶

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

读取首选项模式¶

primary¶

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

primary读取首选项模式与使用标签集或maxStalenessSeconds的读取首选项模式不兼容。如果使用指定标签集或maxStalenessSeconds值primary，则驱动程序将产生错误。

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

primaryPreferred¶

在大多数情况下，操作将从集合的主要成员读取。但是，如果主服务器不可用（如故障转移情况下的情况）， 则将从满足读取首选项和标记集的辅助成员读取操作maxStalenessSeconds。

当primaryPreferred读取首选项包含maxStalenessSeconds值并且没有要读取的主数据库时，客户端通过将辅助数据库的上次写入与最近一次写入的辅助数据库的比较来估计每个辅助数据库的陈旧程度。然后，客户端将读取操作定向到估计延迟小于或等于的辅助节点maxStalenessSeconds。

当读取的首选项包括标签集（即标签规范列表）并且没有要读取的主要标签时，客户端将尝试查找具有匹配标签的辅助成员（按顺序尝试标签规范，直到找到匹配项）。如果找到匹配的次级，则客户端从最近的一组匹配次级中选择一个随机的次级。如果没有辅助节点具有匹配的标签，则读取操作将产生错误。

当读取的首选项包含一个maxStalenessSeconds值 和一个标记集时，客户端将首先按陈旧性过滤，然后按指定的标记过滤。

使用该primaryPreferred模式的读取操作可能会返回陈旧数据。使用该 maxStalenessSeconds选项可避免从辅助对象中读取客户估计过时的内容。

secondary¶

操作仅从集合的次要成员中读取。如果没有备用副本，则此读取操作将产生错误或异常。

大多数副本集至少具有一个辅助副本，但是在某些情况下可能没有可用的辅助副本。例如，如果成员处于恢复状态或不可用，则具有主服务器，辅助服务器和 仲裁器的副本集可能没有任何辅助服务器。

当secondary读取首选项包含maxStalenessSeconds值时，客户端通过将辅助节点的上次写入与主要节点的上次写入进行比较，来估计每个辅助节点的过时程度。然后，客户端将读取操作定向到估计延迟小于或等于的辅助节点maxStalenessSeconds。如果没有主服务器，客户端将使用具有最新写入操作的辅助服务器进行比较。

当读取的首选项包括标签集（即标签规范列表）时，客户端尝试查找具有匹配标签的辅助成员（按顺序尝试标签规范，直到找到匹配项）。如果找到匹配的次级，则客户端从最近的一组匹配次级中选择一个随机的次级。如果没有辅助节点具有匹配的标签，则读取操作将产生错误。

当读取的首选项包含一个maxStalenessSeconds值 和一个标记集时，客户端将首先按陈旧性过滤，然后按指定的标记过滤。

使用该secondary模式的读取操作可能会返回陈旧数据。使用该 maxStalenessSeconds选项可避免从辅助对象中读取客户估计过时的内容。

secondaryPreferred¶

在大多数情况下，操作从辅助成员读取，但是在集合由单个主要成员（无其他成员）组成的情况下 ，读取操作将使用副本集的主要成员。

当secondaryPreferred读取首选项包含maxStalenessSeconds值时，客户端通过将辅助节点的上次写入与主要节点的上次写入进行比较，来估计每个辅助节点的过时程度。然后，客户端将读取操作定向到估计延迟小于或等于的辅助节点maxStalenessSeconds。如果没有主服务器，客户端将使用具有最新写入操作的辅助服务器进行比较。如果不存在估计延迟小于或等于的辅助对象maxStalenessSeconds，则客户端会将读取操作定向到副本集的主对象。

当读取的首选项包括标签集（即标签规范列表）时，客户端尝试查找具有匹配标签的辅助成员（按顺序尝试标签规范，直到找到匹配项）。如果找到匹配的次级，则客户端从最近的一组匹配次级中选择一个随机的次级。如果没有辅助节点具有匹配的标签，则客户端将忽略标签并从主节点读取。

当读取的首选项包含一个maxStalenessSeconds值 和一个标记集时，客户端将首先按陈旧性过滤，然后按指定的标记过滤。

使用该secondaryPreferred模式的读取操作可能会返回陈旧数据。使用该 maxStalenessSeconds选项可避免从辅助对象中读取客户估计过时的内容。

nearest¶

驱动程序从其网络延迟在可接受的延迟窗口内的成员读取。在nearest路由读取操作时，该模式下的读取不考虑成员是主要成员还是次要成员：主要和次要成员被同等对待。已读首选项成员选择文档详细描述了该过程。

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

当读取首选项包含maxStalenessSeconds值时，客户端将比较辅助节点的上次写入与主节点（如果有）的上次写入（如果有的话），或者与没有辅助节点的最近写入进行比较，以估计每个辅助节点的过时状态。然后，客户端将滤除估计滞后时间大于其值的任何辅助 maxStalenessSeconds节点，并将读取结果随机定向到其网络延迟落在可接受的延迟窗口内的其余成员（主要节点或辅助节点） 。

如果指定标签集，客户端将尝试查找与指定标签集匹配的副本集成员，并将读取结果定向到最近的组中的任意成员。

当读取的首选项包含一个maxStalenessSeconds值 和一个标记集时，客户端将首先按陈旧性过滤，然后按指定的标记过滤。mongod然后，客户端将从其余实例中随机将读取定向到可接受的等待时间窗口内的实例。已读首选项成员选择 文档详细描述了该过程。

使用该nearest模式的读取操作可能会返回陈旧数据。使用该 maxStalenessSeconds选项可避免从辅助对象中读取客户估计过时的内容。

注意

从与指定的读取首选项模式匹配的副本集的最接近组的成员读取的所有操作。该 nearest模式的不同之处在于，相比于成员的主要或次要状态，它更喜欢低延迟读取。

对于nearest，客户端根据maxStalenessSeconds和标记集组合可接受的主机列表，然后将该列表缩小到ping时间最短的主机以及该组中所有其他成员都在“本地阈值”或可接受的延迟范围内的主机。有关更多信息，请参见 读取副本集的首选项。

配置读取首选项¶

使用MongoDB驱动程序时，可以在连接到副本集或分片集群时指定读取首选项 。例如，请参阅连接字符串。您还可以在更详细的级别上指定读取首选项。有关详细信息，请参见驱动程序的 api文档。

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

使用mongo外壳时，请参见cursor.readPref() 和Mongo.setReadPref()。例如：

db.collection.find({}).readPref( "secondary",  [ { "region": "South" } ] )

阅读偏好和交易¶

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

其他注意事项¶

对于聚合管道 操作，如果管道包括$out阶段或$merge阶段，则必须在主管道上运行。

对于mapReduce操作，仅mapReduce不写入数据的“内联” 操作支持读取首选项。否则，mapReduce操作必须在主要成员上运行。