reelect()

名称

reelect - 在当前复制组中重新选举

语法

rg.reelect( [options] )

类别

SdbReplicaGroup

描述

在当前复制组中重新选举。

参数

• options（ object，选填 ）

  通过参数 options 可以设置主节点的匹配条件：

  • Seconds（ number ）：选举的超时时间，默认值为 30，单位为秒

    格式：Seconds: 30

  • NodeID（ number or number array ）：期望当选主节点的节点 ID

    格式：NodeID: 1000 或 NodeID: [1000,1001]

  • HostName（ string ）：期望当选主节点的主机名

    如果指定了参数 NodeID，该参数不生效。

    格式：HostName: "hostname"

  • ServiceName（ string ）：期望当选主节点的服务名

    如果指定了参数 NodeID，该参数不生效。

    格式：ServiceName: "11820"

  • Location（ string ）：期望指定该位置集节点当选主节点

    如果指定了参数 NodeID，HostName，ServiceName 任一一个，该参数不生效。

    格式：Location: "sz"

  • Level（ number ）：重选举等待级别，取值：[1,3]，缺省为 3

    • 1: 等待当前写操作结束，并阻塞后续写操作
    • 2: 等待写游标(大对象操作)结束
    • 3: 等待事务结束

    格式：Level: 3

  • Mode（ number ）：节点指定模式，默认为 1

    • 0: 排除模式，排除批定的节点当选为主节点
    • 1: 指定模式，指定的节点当选为主节点

    格式：Mode: 1

Note:

1. 返回超时错误代表在规定时间内重选没有完成。如果返回成功，需等待若干秒，待编目信息异步更新完成后，再通过 db.listReplicaGroups() 观察最终结果。

2. 只有复制组中存在主节点时才可以进行重新选举。

3. 当使用NodeID时，则HostName、ServiceName不生效。

4. 当没有指定具体的 NodeID、ServiceName 的情况下，如果有多个节点都可当选主节点时，此时选举的匹配规则为：节点的 LSN 号（日志序号） > 节点权重 > 节点 ID，优先选取 LSN 号最大的节点，若 LSN 号一致，则选取权重值大的节点，若节点权重一致，则选取节点 ID 最大的节点为主节点。节点的权重设置可以参考数据库配置。

5. 复制组中的可用节点（存活节点）至少需要占总节点数半数以上，才能进行选举。

6. 选举的具体描述可以参考选举机制。

返回值

函数执行成功时，返回一个 BSON 对象，包含以下字段：

函数执行失败时，将抛异常并输出错误信息。

错误

reelect()函数常见异常如下：

如果出错则抛异常，并输出错误信息，可以通过 getLastErrMsg() 获取错误信息，通过 getLastError() 获取错误码。常见错误处理可以参考常见错误处理指南。

错误码

版本

v2.0 及以上版本

v5.8.6 及以上版本支持 Mode、Location 和 NodeID 数组参数，同时支持返回 BSON 对象

示例

在 group1 中进行重新选举，超时时间为60s。

> var rg = db.getRG("group1")
> rg.reelect({Seconds:60})
{
  "OldPrimary": "sdbserver1:11820",
  "NewPrimary": "sdbserver2:11820",
  "Changed": true
}