自管理副本集配置

类型: array

An array of member configuration documents, one for each member of the replica set. The members array is a zero-indexed array.

Each member-specific configuration document can contain the following fields:

members[n]._id

类型：整型

An integer identifier for the member in the replica set, unique among all members.

Starting in MongoDB 5.0, values may be any integer value greater than or equal to 0. Previously, this value was limited to an integer between 0 and 255 inclusive.

Each replica set member must have a unique _id. Avoid re-using _id values even if no members[n] entry is using that _id in the current configuration.

Once set, you cannot change the _id of a member.

注意

When updating the replica configuration object, access the replica set members in the members array with the array index. The array index begins with 0. Do not confuse this index value with the value of the members[n]._id field in each document in the members array.

members[n].host

类型：字符串

The hostname and, if specified, the port number, of the set member.

The hostname name must be resolvable for every host in the replica set.

警告

members[n].host cannot hold a value that resolves to localhost or the local interface unless all members of the set are on hosts that resolve to localhost.

members[n].arbiterOnly

Optional.

类型：布尔值

默认：false

A boolean that identifies an arbiter. A value of true indicates that the member is an arbiter.

When using the rs.addArb() method to add an arbiter, the method automatically sets members[n].arbiterOnly to true for the added member.

members[n].buildIndexes

Optional.

类型：布尔值

默认值：true

A boolean that indicates whether the mongod builds indexes on this member. You can only set this value when adding a member to a replica set. You cannot change members[n].buildIndexes field after the member has been added to the set. To add a member, see rs.add() and rs.reconfig().

Do not set to false for mongod instances that receive queries from clients.

Setting buildIndexes to false may be useful if all the following conditions are true:

• you are only using this instance to perform backups using mongodump, and

• this member will receive no queries, and

• index creation and maintenance overburdens the host system.

Even if set to false, secondaries will build indexes on the _id field in order to facilitate operations required for replication.

警告

If you set members[n].buildIndexes to false, you must also set members[n].priority to 0. If members[n].priority is not 0, MongoDB will return an error when attempting to add a member with members[n].buildIndexes equal to false.

To ensure the member receives no queries, you should make all instances that do not build indexes hidden.

Other secondaries cannot replicate from a member where members[n].buildIndexes is false.

members[n].hidden

Optional.

类型：布尔值

默认：false

When this value is true, the replica set hides this instance and does not include the member in the output of db.hello() or hello. This prevents read operations (i.e. queries) from ever reaching this host by way of secondary 读取偏好.

Hidden members can acknowledge write operations issued with 写关注. For write operations issued with "majority" write concern, the member must also be a voting member (i.e. votes is greater than 0).

另请参阅：

Hidden Replica Set Members

members[n].priority

Optional.

类型: Number between 0 and 1000 for primary/secondary; 0 or 1 for arbiters.

默认: 1.0 for primary/secondary; 0 for arbiters.

A number that indicates the relative likelihood of a replica set member to become the 主节点.

• To increase the likelihood that a member becomes the primary, specify a higher priority value for that member.

• To decrease the likelihood that a member becomes the primary, specify a lower priority value for that member.

Changing a member's priority triggers one or more elections. The election algorithm makes a best-effort attempt to elect the highest-priority member the primary. However, a lower-priority member may become the primary even if a higher-priority secondary is available.

If a lower-priority member becomes the primary, the server continues to periodically call elections until the highest-priority replica set member is the primary. The frequency at which the elections occur depends on the difference in priority between the elected member and the highest-priority member.

A member with a priority of 0 cannot become the primary.

Non-voting members (meaning members that have votes set to 0) must have a priority of 0.

另请参阅：

• Replica Set Elections

• Member Priority

members[n].tags

Optional.

类型：文档

默认：无

一份 tags 文档包含用户定义的副本集节点标签字段和值对。

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

• 对于读取操作，您可以在读取偏好中指定标签集，以将操作定向到具有指定标签的副本集节点员。

• For write operations, you can create a customize 写入安全机制 using settings.getLastErrorModes and settings.getLastErrorDefaults。

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

members[n].secondaryDelaySecs

Optional.

类型：整型

默认: 0

The number of seconds "behind" the primary that this replica set member should "lag".

Use this option to create delayed members. Delayed members maintain a copy of the data that reflects the state of the data at some time in the past.

Delayed members can contribute to acknowledging write operations issued with 写关注. However, they return write acknowledgment no earlier than the configured delay value. For write operations issued with "majority" write concern, the member must also be a voting member (i.e. votes is greater than 0).

另请参阅：

Delayed Replica Set Members

members[n].votes

Optional.

类型：整型

默认: 1

The number of votes a server will cast in a replica set election. The number of votes each member has is either 1 or 0, and arbiters always have exactly 1 vote.

Members with priority greater than 0 cannot have 0 votes。

A replica set can have up to 50 members but only 7 voting members. If you need more than 7 members in one replica set, set members[n].votes to 0 for the additional non-voting members.

Non-voting (i.e. votes is 0) members must have priority of 0.

Starting in MongoDB 5.0, a newly added secondary does not count as a voting member and cannot be elected until it has reached SECONDARY state.

Non-voting members cannot acknowledge write operations issued with a "majority" write concern.

另请参阅：

• replSetGetStatus.votingMembersCount

• replSetGetStatus.writableVotingMembersCount

Optional.

类型：文档

A document that contains configuration options that apply to the whole replica set.

The settings document contain the following fields:

settings.chainingAllowed

Optional.

类型：布尔值

默认值：true

In MongoDB 5.0.1 and earlier, if settings.chainingAllowed is:

• true, replica set 从节点 members can replicate data from other secondary members.

• false, secondary members can replicate data only from the 主节点.

Starting in MongoDB 5.0.2:

• 副本集 从节点 members can replicate data from other secondary members even if settings.chainingAllowed is false.

• To override settings.chainingAllowed, set the enableOverrideClusterChainingSetting server parameter to true.

• The default for enableOverrideClusterChainingSetting is false.

另请参阅：

Self-Managed Chained Replication

settings.getLastErrorDefaults

Optional.

类型：文档

Unavailable starting in MongoDB 5.0.

重要

Starting in MongoDB 5.0, you cannot specify a default write concern with settings.getLastErrorDefaults other than the default of { w: 1, wtimeout: 0 } . Instead, use the setDefaultRWConcern command to set the default read or write concern configuration for a replica set or sharded cluster.

settings.getLastErrorModes

Optional.

类型：文档

A document used to define a custom 写入安全机制 through the use of members[n].tags. The custom write concern can provide 数据中心可知性.

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

The <number> refers to the number of different tag values required to satisfy the write concern. For example, the following settings.getLastErrorModes defines a write concern named datacenter that requires the write to propagate to two members whose dc tag values differ.

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

To use the custom write concern, pass in the write concern name to the w 选项, e.g.

{ w: "datacenter" }

See 配置副本集标签集 for more information and example.

settings.heartbeatTimeoutSecs

Optional.

类型：int

默认: 10

Number of seconds that the replica set members wait for a successful heartbeat from each other. If a member does not respond in time, other members mark the delinquent member as inaccessible.

settings.electionTimeoutMillis

Optional.

类型：int

默认: 10000 (10 seconds)

The time limit in milliseconds for detecting when a replica set's primary is unreachable. This setting controls failover sensitivity when using protocolVersion: 1. You can expect the failover timeout to not exceed the value of electionTimeoutMillis.

Consider the following when selecting a value:

• Higher values result in slower failovers but decreased sensitivity to primary node or network slowness or spottiness.

• Lower values result in faster failover but increased sensitivity to primary node or network slowness or spottiness.

The setting only applies when using protocolVersion: 1。

注意

When you step down a primary using rs.stepDown() or replSetStepDown without setting the force field to true, the stepped-down primary nominates an eligible secondary to call an election immediately.

settings.catchUpTimeoutMillis

Optional.

类型：int

默认: -1, infinite catchup time.

Time limit in milliseconds for a newly elected primary to sync (catch up) with the other replica set members that may have more recent writes. Infinite or high time limits may reduce the amount of data that the other members would need to roll back after an election but may increase the failover time.

The newly elected primary ends the catchup period early once it is fully caught up with other members of the set. During the catchup period, the newly elected primary is unavailable for writes from clients. Use replSetAbortPrimaryCatchUp to abort the catchup then complete the transition to primary.

The setting only applies when using protocolVersion: 1。

settings.catchUpTakeoverDelayMillis

Optional.

类型：int

默认: 30000 (30 seconds)

Time in milliseconds a node waits to initiate a catchup takeover after determining it is ahead of the current 主节点. During a catchup takeover, the node ahead of the current primary initiates an 选举 to become the new primary of the 复制集.

After the node initiating the takeover determines that it is ahead of the current 主节点, it waits the specified number of milliseconds and then verifies the following:

1. It is still ahead of the current primary,

2. It is the most up-to-date node among all available nodes,

3. The current primary is currently catching up to it.

Once determining that all of these conditions are met, the node initiating the takeover immediately runs for election.

For more information on Replica Set Elections, see Replica Set Elections.

注意

Setting catchUpTakeoverDelayMillis to -1 disables catchup takeover. Setting catchUpTimeoutMillis to 0 disables primary catchup and consequently also catchup takeover.

settings.heartbeatIntervalMillis

Internal use only.

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

settings.replicaSetId

类型: ObjectId

The ObjectId associated with the replica set and automatically created during rs.initiate() or replSetInitiate. You cannot change the replicaSetId。