replSetStepDown

在本页面

• Description

• Behavior

• Examples

Description

• replSetStepDown
  • 指示副本集的primary成为secondary。初级降级后，合格的次级将持有初选。

该命令不会立即降级主要数据库。如果没有electable个辅助节点与主节点保持最新，则主节点最多 awaitsecondaryCatchUpPeriodSecs个(默认情况下为 10 秒)以使辅助节点赶上。一旦可以选择的辅助服务器可用，该命令将降级主服务器。

降级后，原始的主要节点将成为辅助节点，并且在replSetStepDown: <seconds>指定的剩余时间内没有资格再次成为主要节点。

有关命令执行的详细说明，请参见Behavior。

replSetStepDown只能在admin数据库上运行，并且具有以下原型形式：

db.adminCommand( {
    replSetStepDown: <seconds>,
    secondaryCatchUpPeriodSecs: <seconds>,
    force: <true|false>
} )

replSetStepDown将以下字段作为参数：

降级周期从mongod接收命令开始。降压周期必须大于secondaryCatchUpPeriodSecs。
| secondaryCatchUpPeriodSecs |数字|可选。 mongodawait 可选举的辅助节点赶上主要节点的秒数。
如果指定，则secondaryCatchUpPeriodSecs会覆盖默认的 await 时间10秒或force: true，0秒。
| force |布尔值|可选。一个布尔值，用于确定在 await 期内是否不存在可选举且最新的辅助节点，主要节点是否降级。
如果true，则即使不存在合适的辅助成员，主要成员也将下台；否则，如果具有复制滞后的辅助节点变为新的主要节点，则可能会导致rollbacks。
如果false，则在不存在合适的辅助成员的情况下，主节点不会降级，并且该命令返回错误。
默认为false。

Behavior

Concurrent Operations

replSetStepDown命令尝试终止长时间运行的用户操作，这些操作会阻止主数据库降级，例如索引构建，写操作或 Map 减少作业。

合格中学的可用性

然后，该命令启动一个追赶期，在此期间它最多 awaitsecondaryCatchUpPeriodSeconds，默认情况下 await10 秒，以使辅助节点与主节点保持最新状态。仅当辅助服务器在追赶期间与主服务器保持最新时，主服务器才会降级，以防止rollbacks。

如果在 await 期结束之前没有可选举的辅助节点满足此条件，则主要节点不会降级并且命令错误。您可以覆盖此行为，并使用force: true选项发出命令以立即降级主数据库。

一旦主要节点成功降级，该节点就无法在replSetStepDown: <seconds>期间的剩余时间内成为主要节点，该时间段是在该节点收到命令后开始的。

Client Connections

replSetStepDown命令强制当前连接到数据库的所有 Client 端断开连接。这有助于确保 Client 端维护副本集的准确视图。

因为断开连接包括用于运行命令的连接，所以如果命令成功完成，则无法检索命令的返回状态。如果错误，则只能检索命令的返回状态。在脚本中运行命令时，脚本应解决此问题。

降压期间的写入

Election Handoff

在版本 3.6.7 中进行了更改：如果参数enableElectionHandoff为 true(默认值)，则当主节点从rs.stepDown()降级(或没有force: true的replSetStepDown命令)时，降级的主节点将提名合格的辅助节点立即选举。否则，次要人员最多可以 awaitsettings.electionTimeoutMillis才能进行选举。降级的主服务器不 await 切换的效果。有关更多信息，请参见enableElectionHandoff。

Examples

使用默认选项下移

以下示例在当前主数据库上运行，尝试将成员降级120秒。

该操作最多 await 默认的10秒，以使辅助服务器赶上来。如果不存在合适的辅助节点，则主节点不会降级并且命令错误。

db.adminCommand( { replSetStepDown: 120 } )

指定辅助追赶的 await 时间

下面的示例在当前主节点上运行，尝试将成员降级120秒，最多 await15秒以 await 可选举的辅助节点赶上。如果不存在合适的辅助节点，则主节点不会降级并且命令错误。

db.adminCommand( { replSetStepDown: 120, secondaryCatchUpPeriodSecs: 15 } )

指定强制降级的辅助追赶

下面的示例在当前主节点上运行，尝试将成员降级120秒，最多 await15秒以 await 可选举的辅助节点赶上。由于使用force: true选项，即使不存在合适的辅助节点，主节点也会降级。

db.adminCommand( { replSetStepDown: 120, secondaryCatchUpPeriodSecs: 15, force: true } )