rs.reconfig()

在本页面

Definition

rs. reconfig(* configuration ， force *)
- 重新配置现有副本集，覆盖现有副本集配置。要运行该方法，必须连接到副本集的primary。

Parameter	Type	Description
`configuration`	document	document，用于指定副本集的配置。
`force`	document	可选的。如果设置为`{ force: true }`，即使大多数成员不可访问，这也会强制副本集接受新配置。请谨慎使用，因为这可能导致rollback情况。

要重新配置现有副本集，请首先使用rs.conf()检索当前配置，根据需要修改配置文档，然后将修改后的文档传递给rs.reconfig()。

rs.reconfig()提供围绕replSetReconfig命令的包装。

force参数允许向非主节点发出重新配置命令。

Consideration

混合版本副本集

Warning

避免重新配置包含不同 MongoDB 版本成员的副本集，因为验证规则在 MongoDB 版本之间可能有所不同。

Availability

rs.reconfig() shell 方法可以在某些情况下触发当前的主数据库降级。当主服务器降级时，它将强制关闭所有 Client 端连接。主降压触发election选择新的primary。

假设默认为副本配置设置，集群选择新的主要数据库之前的中值时间通常不应超过 12 秒。这包括将主要对象标记为unavailable并调用并完成election所需的时间。您可以通过修改settings.electionTimeoutMillis复制配置选项来调整此时间段。网络延迟之类的因素可能会延长完成副本集选举所需的时间，进而影响群集在没有主数据库的情况下可以运行的时间。这些因素取决于您的特定群集体系结构。

在选择过程中，群集在选择新的主数据库之前不能接受写操作。

您的应用程序连接逻辑应包括对自动故障转移和后续选举的容忍度。

3.6 版中的新功能：MongoDB 3.6 驱动程序可以一次检测到主数据库的丢失并自动重试某些写入操作，从而提供了对自动故障转移和选举的其他内置处理。

为了进一步减少对生产集群的潜在影响，请仅在计划的维护期间重新配置。

{ force: true }

Warning

将rs.reconfig()与{ force: true }结合使用会导致rollback的提交写入。使用此选项时请多加注意。

会员优先级和投票

在版本 3.2 中更改。

priority大于 0 的成员不能有 0 votes。
非投票成员的priority必须为 0.

protocolVersion

更改protocolVersion之前，请确保至少有一个 oplog 条目(从当前协议版本生成)已从主服务器复制到所有辅助服务器。有关详细信息，请参见修改副本集协议版本。

Examples

名为rs0的副本集具有以下配置：

{
   "_id" : "rs0",
   "version" : 1,
   "protocolVersion" : NumberLong(1),
   "members" : [
      {
         "_id" : 0,
         "host" : "mongodb0.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 1,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      },
      {
         "_id" : 1,
         "host" : "mongodb1.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 1,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      },
      {
         "_id" : 2,
         "host" : "mongodb2.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 1,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      }
   ],
   "settings" : {
      "chainingAllowed" : true,
      "heartbeatIntervalMillis" : 2000,
      "heartbeatTimeoutSecs" : 10,
      "electionTimeoutMillis" : 10000,
      "catchUpTimeoutMillis" : 2000,
      "getLastErrorModes" : {

      },
      "getLastErrorDefaults" : {
         "w" : 1,
         "wtimeout" : 0
      },
      "replicaSetId" : ObjectId("58858acc1f5609ed986b641b")
   }
}

以下操作序列更新第二个成员的members[n].priority。通过连接到主数据库的mongo shell 发出操作。

cfg = rs.conf();
cfg.members[1].priority = 2;
rs.reconfig(cfg);

第一条语句使用rs.conf()方法为副本集检索包含当前configuration的文档，并将该文档设置为局部变量cfg。
第二条语句为members数组中的第二个文档设置members[n].priority值。有关其他设置，请参见副本集配置设置。

要访问数组中的成员配置文档，该语句使用数组索引和副本集成员的members[n]._id字段(而非**)。

最后一条语句使用修改后的cfg调用rs.reconfig()方法以初始化此新配置。成功重新配置后，副本集配置将类似于以下内容：

{
   "_id" : "rs0",
   "version" : 2,
   "protocolVersion" : NumberLong(1),
   "members" : [
      {
         "_id" : 0,
         "host" : "mongodb0.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 1,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      },
      {
         "_id" : 1,
         "host" : "mongodb1.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 2,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      },
      {
         "_id" : 2,
         "host" : "mongodb2.example.net:27017",
         "arbiterOnly" : false,
         "buildIndexes" : true,
         "hidden" : false,
         "priority" : 1,
         "tags" : {

         },
         "slaveDelay" : NumberLong(0),
         "votes" : 1
      }
   ],
   "settings" : {
      "chainingAllowed" : true,
      "heartbeatIntervalMillis" : 2000,
      "heartbeatTimeoutSecs" : 10,
      "electionTimeoutMillis" : 10000,
      "catchUpTimeoutMillis" : 2000,
      "getLastErrorModes" : {

      },
      "getLastErrorDefaults" : {
         "w" : 1,
         "wtimeout" : 0
      },
      "replicaSetId" : ObjectId("58858acc1f5609ed986b641b")
   }
}

Docs

Docs4dev

Title here