reelectLocation()

名称

reelectLocation - 重新选举位置集中的主节点

语法

rg.reelectLocation(<location>, [options])

类别

SdbReplicaGroup

描述

该函数用于在当前复制组中，对指定位置集的主节点进行重选举。

参数

• location（ string，必填 ）

  位置信息

• options（ object，选填 ）

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

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

    格式：Seconds: 50

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

    格式：NodeID: 1000

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

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

    格式：HostName: "hostname"

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

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

    格式：ServiceName: "11820"

Note:

• 当匹配到多个节点时，将在所匹配到的节点中随机选择主节点。
• 如果未指定参数 NodeID、HostName 和 ServiceName，系统将依据选举机制自动匹配节点。
• 同时指定参数 HostName 和 ServiceName，在参数生效的情况下，将匹配同时满足两个条件的节点。

返回值

函数执行成功时，无返回值。

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

错误

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

当异常抛出时，可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。

版本

v3.6.1 及以上版本

示例

1. 对复制组 group1 下的位置集 GuangZhou 执行重选举操作，将 NodeID 为 1000 的节点设置为主节点

   > var rg = db.getRG("group1")
   > rg.reelectLocation("GuangZhou", {NodeID: 1000})

2. 查看当前位置集对应的主节点 ID

   > db.list(SDB_LIST_GROUPS, {"GroupName": "group1"}, {"Locations.Location": null, "Locations.PrimaryNode": null})
   {
     "Locations": [
       {
         "Location": "GuangZhou",
         "PrimaryNode": 1000
       }
     ]
   }