连接地址限制

• 当前仅在私网连接地址中支持使用只读节点。
• 若副本集实例存在只读节点，开启公网解析时会同时为只读节点的内网地址开启公网解析功能。

数量限制

MongoDB 实例类型不同，支持添加的只读节点数量不同。其中：

• 副本集：每个实例最多可添加至 5 个只读节点。
• 分片集群：仅 Shard 分片支持添加只读节点，每个 Shard 分片最多可添加至 5 个只读节点。

变更配置限制

• 只读节点的规格与实例（或 Shard 分片）的主从节点规格保持一致，因此升级或降级副本集实例规格或分片集群 Shard 节点规格时，已添加的只读节点规格也会同步变更。
• 变更只读节点数量操作与副本集实例中其它配置变更操作互斥，即变更副本集实例的节点规格或存储空间时，不支持同时变更只读节点数量。
• 仅当分片集群实例中不存在只读节点，且所有 Shard 分片的配置（包括节点规格和存储空间）一样时，才支持开启批量修改 Shard 分片配置功能。

更多关于变更实例配置的更多详情，请参见变更实例配置。

其他限制

• 只读节点仅供读请求访问，不参与主从节点选举。
• 只读节点与主节点或从节点之间的数据复制方式为异步复制。正常情况下存在毫秒级的延迟，在主节点写入压力大的时候可能出现秒级的延迟。

主节点（Primary Node）

也称主库，可提供读写功能。集群状态正常时，来自客户端的所有数据都会写入主节点。

• 每个副本集实例中只能有一个主节点。
• 每个分片集群的 Shard 分片中只能有一个主节点。

从节点（Secondary Node）

保障高可用，通过 oplog（操作日志）同步主节点的数据，可在主节点故障时通过选举成为新的主节点。

• 主节点故障时，从节点支持提升为主节点，来执行和响应数据的读写请求。
• 客户端连接从节点时，只能读取数据不能写入数据。

隐藏节点（Hidden Node）

仅用于保障高可用，对用户不可见。通过 oplog 同步主节点的数据，可在从节点故障时接替该故障节点成为新的从节点保障高可用。

• 每个副本集实例中只能有一个隐藏节点。
• 每个分片集群的 Shard 分片中只能有一个隐藏节点。
• 隐藏节点只参与投票选取主节点，不能被选举为主节点。

只读节点（ReadOnly Node）

主要适用于数据量极大的读请求场景，其通过操作日志（oplog）从主节点或从节点同步数据，系统将读请求自动路由至只读节点，以减轻主节点访问压力。

• 只读节点具有独立的连接地址，适合独立系统及应用直连访问，与已有主从节点的连接互不干扰。
• 只读节点不会被选举为主节点，也不会参与投票选举主节点。
• 只读节点与主节点或从节点之间的数据复制方式为异步复制。

<host>:3717

必填

只读节点所对应的域名和端口号，默认端口号为 3717。
当前仅副本集实例和分片集群实例中 Shard 分片的私网地址支持通过只读节点连接。其中：

• 副本集实例：单独提供一个包含了所有只读节点的私网连接地址。

  

• 分片集群实例：仅 Shard 分片的私网地址中会包含只读节点的连接地址。
  

• 副本集实例只读节点连接地址域名示例：

  mongoreplicae047fe00****100.mongodb.ivolces.com:3717

• 分片集群实例只读节点连接地址域名示例：

  mongoshard9a2ab41e****s0100.mongodb.ivolces.com``:3717

authSource

必填

设置鉴权数据库名称，默认鉴权数据库为 admin。
数据库账号必须在所属的数据库下进行鉴权，才能鉴权成功。

authSource=admin

readPreference

选填

用于实现只读节点地址的读写分离和负载均衡。该参数可以将写请求发送到主节点，读请求随机发送到从节点和只读节点，可选取值如下：

• readPreference=secondary：如果从节点和只读节点都出现故障，读请求失败，不会发送到主节点。
• readPreference=secondaryPreferred：如果从节点和只读节点都出现故障，该参数将读请求发送到主节点。

readPreference=secondary

readPreferenceTags

选填

该参数可以将读请求优先发送到标签对应的只读节点。固定取值为role:readonly，不允许修改。

readPreferenceTags=role:readonly