Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
mongosh 方法
/
游标

cursor.readPref()

在此页面上

  • 定义
  • 举例

定义

cursor.readPref(mode, tagSet, hedgeOptions)

重要

mongosh 方法

这是一个 mongosh方法。 这不是Node.js或其他特定于编程语言的驱动程序方法的文档。

在大多数情况下， mongosh方法的工作方式与传统 mongo shell 方法相同。但是，某些旧方法在mongosh中不可用。

有关旧版mongo shell 文档，请参阅相应 MongoDB Server 版本的文档：

对于 MongoDB API 驱动程序，请参阅特定语言的MongoDB 驱动程序文档。

将readPref()附加到游标以控制客户端如何将查询路由到副本集的成员。

注意

在从数据库检索任何文档之前，必须对游标应用 readPref()。

参数

参数
类型
说明
字符串
文档数组

可选。 用于将读取定位到具有指定标签的成员的标签集。 如果使用primary ，则tagSet不可用。

有关详细信息，请参阅读取偏好（read preference）标签集列表。

文档

可选。 指定是否启用对冲读的文档。

{ enabled: <boolean> }

enabled字段默认为 true；即指定空文档{ }相当于指定{ enabled: true } 。

对冲读可用于分片集群。要使用对冲读，mongos 必须有 enabled support 用于对冲读（默认值），非 primary 读取偏好必须启用对冲读。

默认情况下，读取偏好（read preference）nearest允许在分片集群上使用对冲读；即默认情况下具有{ enabled: true } 。

readPref() 不支持读取偏好的读取偏好 maxStalenessSeconds 选项。

举例

指定读取偏好（read preference）模式

以下操作使用读取偏好模式将读取定位到从节点成员。

db.collection.find({ }).readPref( "secondary")

指定读取偏好标签集

要以特定标签定位从节点，请包含模式和 tagSet 数组：

db.collection.find({ }).readPref(
   "secondary",
   [
      { "datacenter": "B" },    // First, try matching by the datacenter tag
      { "region": "West"},      // If not found, then try matching by the region tag
      { }                       // If not found, then use the empty document to match all eligible members
   ]
)

在从节点选择过程中，MongoDB 会尝试首先找到带有datacenter: "B"标签的从节点。

  • 如果找到，MongoDB 会将符合条件的从节点限制为带有datacenter: "B"标签的从节点，并忽略其余标签。

  • 如果未找到，MongoDB 会尝试查找带有"region": "West"标签的从节点。

    • 如果找到，MongoDB 会将符合条件的从节点限制为带有"region": "West"标签的从节点。

    • 如果未找到，MongoDB 将使用任何符合条件的从节点。

有关详细信息，请参阅标签匹配顺序。

提示

另请参阅：

配置副本集标签集

指定对冲读

对于分片集群，您可以为非主节点读取偏好启用对冲读。要使用对冲读，mongos 必须有 enabled support 用于对冲读（默认值），非 primary 读取偏好必须启用对冲读。

要使用对冲读来定位分片集群上的从节点，请同时包含模式和对冲选项，如下例所示：

  • 没有标签集

    db.collection.find({ }).readPref(
       "secondary",            // mode
       null,                   // tag set
       { enabled: true }       // hedge options
    )

  • 有标签集

    db.collection.find({ }).readPref(
       "secondary",                      // mode
       [ { "datacenter": "B" },  { } ],  // tag set
       { enabled: true }                 // hedge options
    )

后退

cursor.readConcern

来年

cursor.returnKey

在此页面上