副本集配置

类型：数组

成员配置文档的数组，副本集的每个成员一个。该members数组是零索引数组。

每个特定于成员的配置文档都可以包含以下字段：

members[n]._id¶

类型：整数

副本集中每个成员的整数标识符。值必须介于0到255之间（含0和255）。每个副本集成员必须具有唯一的_id。设置后，您将无法更改_id成员的。

注意

更新副本配置对象时，请使用数组索引访问members数组中 的副本集成员。数组索引以开头。千万不能混淆与价值这个指标值 字段中的每个文件中的数组。0members[n]._idmembers

members[n].host¶

类型：字符串

set成员的主机名和端口号（如果指定）。

对于副本集中的每个主机，主机名名称都必须是可解析的。

警告

members[n].hostlocalhost除非集合的所有成员都在解析为的主机上， 否则无法保存解析为或本地接口的值localhost。

members[n].arbiterOnly¶

可选的。

类型：布尔值

默认值：false

标识仲裁者的布尔值。值true 表示该成员是仲裁者。

当使用rs.addArb()方法添加的仲裁器，所述方法自动设置 members[n].arbiterOnly到true 所添加的部件。

对于以下版本的MongoDB， 与带有仲裁器的副本集相比（在MongoDB 4.0+中不再支持）pv1，w:1回滚的可能性增加了pv0：

• MongoDB 3.4.1
• MongoDB 3.4.0
• MongoDB 3.2.11或更早版本

请参见副本集协议版本。

members[n].buildIndexes¶

可选的。

类型：布尔值

默认值：true

一个布尔值，指示是否在此成员上mongod建立 索引。仅当将成员添加到副本集时才能设置此值。members[n].buildIndexes将成员添加到集合后，您将无法更改 字段。要添加成员，请参见 rs.add()和rs.reconfig()。

false对于mongod接收来自客户端的查询的实例，请不要设置为。

如果 满足以下所有条件，则设置buildIndexes为false可能会有用：

• 您只使用这个实例来执行备份使用 mongodump，并
• 该成员将不会收到任何查询，并且
• 索引创建和维护使主机系统负担沉重。

即使设置为false，secondary 也会在_id字段上建立索引， 以简化复制所需的操作。

警告

如果设置 members[n].buildIndexes为 false，则还必须设置 members[n].priority为0。如果 members[n].priority不是 0，则MongoDB在尝试添加members[n].buildIndexes等于 的成员时将返回错误 false。

为确保成员不接收任何查询，应将所有未构建索引的实例都隐藏起来。

其他辅助节点不能从成员members[n].buildIndexes为false 的成员复制 。

members[n].hidden¶

可选的。

类型：布尔值

默认值：false

当该值为时true，副本集将隐藏该实例，并且在db.isMaster()或的输出中不包括该成员 isMaster。这样可以防止读取操作（即查询）通过次要读取首选项到达此主机。

隐藏的成员可以确认由Write Concern发出的写操作。对于发出"majority"写关注的写操作，该成员还必须是有投票权的成员（即votes大于0）。

也可以看看

隐藏副本集成员

members[n].priority¶

在3.6版中进行了更改：从MongoDB 3.6开始，仲裁者具有优先权0。如果仲裁程序的优先级为1，则MongoDB 3.6会将仲裁程序重新配置为优先级为0。

可选的。

类型：主要/次要介于0和1000之间的数字；仲裁者为0或1。

默认值：主要/次要为1.0；仲裁者为0。

表示会员成为主要会员的相对资格的数字。

指定较高的值以使成员更有资格成为 主要成员，而指定较低的值以使成员不太 合格。用甲构件members[n].priority的0是不能成为主。

priority大于0的成员不能具有0 votes。

更改副本集中的优先级平衡将触发一个或多个选择。如果在较高优先级的辅助节点上选举了较低优先级的辅助节点，则副本集成员将继续进行选举，直到最高优先级的可用成员成为主要成员。

具有priority的成员0可以确认由Write Concern发出的写操作。对于发出"majority"写关注的写操作，该成员还必须是有投票权的成员（即 votes大于0）。

也可以看看

副本集选举。

members[n].tags¶

可选的。

类型：文件

默认值：无

甲tags文档包含副本集构件用户定义标签字段和值对。

{ "<tag1>": "<string1>", "<tag2>": "<string2>",... }

• 对于读取操作，可以在读取首选项中指定一个标记集，以将操作定向到具有指定标记的副本集成员。
• 对于写操作，您可以使用 和 创建自定义写关注。settings.getLastErrorModessettings.getLastErrorDefaults

有关更多信息，请参见 配置副本集标记集。

members[n].slaveDelay¶

可选的。

类型：整数

默认值：0

此副本集成员应“落后”主要人员“后”的秒数。

使用此选项可以创建延迟成员。延迟成员维护数据的副本，以反映过去某个时间的数据状态。

延迟的成员可能有助于确认由Write Concern发出的写操作。但是，它们不早于配置的延迟值返回写确认。对于发出"majority"写关注的写操作 ，该成员还必须是有投票权的成员（即votes大于 0）。

也可以看看

延迟副本集成员

members[n].votes¶

可选的。

类型：整数

默认值：1

服务器将在副本集选举中投票的票数。每个成员的投票数为1或0，而仲裁员始终拥有正确的1投票权。

priority大于0的成员不能具有0 votes。

一个副本集最多可以有7个投票成员。如果你需要在一个副本集超过7名成员，设置 到了额外的非投票成员。50 membersmembers[n].votes0

在版本3.2中更改：非投票成员必须priority为0。

具有0投票权的成员无法确认发出“ 写入关注点”的写入操作majority。

可选的。

类型：文件

包含适用于整个副本集的配置选项的文档。

该settings文档包含以下字段：

settings.chainingAllowed¶

可选的。

类型：布尔值

默认值：true

当settings.chainingAllowed是 true时，副本集允许二次从其它次要部件成员复制。如果 settings.chainingAllowed是 false，则次要服务器只能从主要服务器复制。

也可以看看

管理链式复制

settings.getLastErrorDefaults¶

可选的。

类型：文件

指定副本集写关注点的文档。副本集仅在进行写操作时才使用此写关注，或者不 getLastError指定其他写关注。

如果settings.getLastErrorDefaults未设置，则副本集的默认写关注只需要主数据库的确认。

settings.getLastErrorModes¶

可选的。

类型：文件

用于通过使用定义自定义写关注点的文档members[n].tags。定制写关注点可以提供数据中心意识。

复制

{ getLastErrorModes: {
   <name of write concern> : { <tag1>: <number>, .... },
   ...
} }

该<number>指满足写入需要关注不同的标签值的数量。例如，以下内容 settings.getLastErrorModes定义了一个名为“写入关注点” datacenter，要求将写入传播到两个dc标签值不同的成员。

复制

{ getLastErrorModes: { datacenter: { "dc": 2 } } }

要使用定制写关注点，请将写关注点名称传递给w Option，例如

复制

{ w: "datacenter" }

有关更多信息和示例，请参见配置副本集标记集。

settings.heartbeatTimeoutSecs¶

可选的。

类型：int

默认值：10

副本集成员等待彼此成功发出心跳的秒数。如果一个成员未及时响应，则其他成员会将违约成员标记为不可访问。

注意

因为pv1， settings.electionTimeoutMillis对次要成员是否要求选举的影响比选举权影响大settings.heartbeatTimeoutSecs。

settings.electionTimeoutMillis¶

3.2版中的新功能。

可选的。

类型：int

默认值：10000（10秒）

检测副本集主数据库何时不可达的时间限制（以毫秒为单位）：

• 较高的值会导致较慢的故障转移，但会降低对主节点或网络的速度或斑点的敏感度。
• 较低的值将导致更快的故障转移，但会增加对主节点或网络缓慢或斑点的敏感性。

该设置仅在使用时适用。protocolVersion: 1

注意

在版本4.0.2中更改：如果参数enableElectionHandoff为true（默认值），则当主要节点从rs.stepDown() （或replSetStepDown不带的命令）降级时，降级的主要节点将提名合格的辅助节点立即召集选举。否则，次要人员可以等到选举开始。降级的主服务器不等待切换的效果。有关更多信息，请参见 。force: truesettings.electionTimeoutMillisenableElectionHandoff

settings.catchUpTimeoutMillis¶

3.4版的新功能。

可选的。

类型：int

在3.6版中进行了更改：

默认值：-1，无限追赶时间。

新选举的主数据库与其他可能具有更近期写入操作的副本集成员同步（追赶）的时间限制（以毫秒为单位）。无限或高时间限制可能会减少选举后其他成员需要回滚的数据量，但可能会增加故障转移时间。

新当选的主要成员在与集合中的其他成员完全同步后，将尽早结束该过渡期。在追赶期间，新选择的主服务器不可用于来自客户端的写入。使用replSetAbortPrimaryCatchUp 中止追赶然后完成过渡到小学。

该设置仅在使用时适用。protocolVersion: 1

注意

要将版本3.6中启动的副本集降级为3.4，请catchUpTimeoutMillis从更改-1为正数。无法将此值更改为正数会导致运行版本3.4的节点既不重新启动也不加入副本集。

settings.catchUpTakeoverDelayMillis¶

3.6版的新功能。

可选的。

类型：int

默认值：30000（30秒）

确定节点超前于当前 主节点之后，节点等待启动追赶接管的时间（以毫秒为单位） 。在追赶接管期间，当前主节点之前的节点会发起选举，以成为副本集的新主节点。

在发起接管的节点确定它在当前主节点之前，它会等待指定的毫秒数，然后验证以下内容：

1. 它仍然领先于当前的主要数据库，
2. 它是所有可用节点中最新的节点，
3. 当前的主数据库正在赶上它。

一旦确定满足所有这些条件，发起接管的节点将立即运行以进行选举。

有关副本集选择的更多信息，请参见副本集选择。

注意

设置catchUpTakeoverDelayMillis为-1禁用追赶接管。设置catchUpTimeoutMillis为 0禁用主要追赶，因此也禁止追赶接管。

settings.heartbeatIntervalMillis¶

3.2版中的新功能。

仅供内部使用。

心跳的频率（以毫秒为单位）。

settings.replicaSetId¶

3.2版中的新功能。

类型：ObjectId

与副本集关联并在rs.initiate()或 期间自动创建的ObjectId replSetInitate。您无法更改 replicaSetId。