getSlave()

名称

getSlave - 获取当前分区组的备节点。

语法

rg.getSlave([positions])

类别

Replica Group

描述

获取当前分区组的备节点。

参数

  • positions ( Int32， 选填 )

节点位置。目前，节点位置定义为该节点在 catalog 元数据的 "Group" 数组中的位置。其起始值为1，范围为[1,7]。最多只能输入7个不重复的、有效节点位置。若指定的节点位置大于分区组的节点数，这些节点位置将按照公式 (position - 1) % nodeCount + 1 进行转换。

返回值

成功：返回 SdbNode 对象。

失败：抛出异常。

Note:

  • 当分区组只有一个节点，不管是否指定节点位置，直接返回唯一的节点对象，即使该节点为主节点。
  • 当分区组有多个节点，在不指定节点位置的情况下，返回的节点必为备节点。
  • 当分区组有多个节点，在指定节点位置的情况下，若节点位置包含备节点，则随机返回包含的备节点；若节点位置只包含主节点，则返回主节点。

错误

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

错误码错误类型描述解决方法
-6SDB_INVALIDARG参数错误。输入的节点位置参数有误。
-10SDB_SYS系统错误。一般由 catalog 元素数据变更后，驱动无法解析元数据导致。
-154SDB_CLS_GRP_NOT_EXIST分区组不存在。检查分区组是否存在。
-158SDB_CLS_EMPTY_GROUP分区组为空。检查分区组是否包含任何节点。

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

版本

  • v2.10加入节点位置参数，用于获取指定位置的备节点。
  • v1.0 添加此接口。

示例

  • 获取 group1 分区组的备节点。
  1. > var rg = db.getRG("group1")
  2. > rg.getSlave()
  3. hostname1:42000
  • group1 分区组信息如下：
  1. > db.list(SDB_LIST_GROUPS, {"GroupName":"group1"})
  2. {
  3. "Group": [
  4.     {
  5.     "HostName": "hostname1",
  6.     "Status": 1,
  7.     "dbpath": "/sequoiadb/database/40000/",
  8.     "Service": [
  9.         {
  10.         "Type": 0,
  11.         "Name": "40000"
  12.         },
  13.         {
  14.         "Type": 1,
  15.         "Name": "40001"
  16.         },
  17.         {
  18.         "Type": 2,
  19.         "Name": "40002"
  20.         }
  21.     ],
  22.     "NodeID": 1001
  23.     },
  24.     {
  25.     "HostName": "hostname1",
  26.     "Status": 1,
  27.     "dbpath": "/sequoiadb/database/41000/",
  28.     "Service": [
  29.         {
  30.         "Type": 0,
  31.         "Name": "41000"
  32.         },
  33.         {
  34.         "Type": 1,
  35.         "Name": "41001"
  36.         },
  37.         {
  38.         "Type": 2,
  39.         "Name": "41002"
  40.         }
  41.     ],
  42.     "NodeID": 1002
  43.     },
  44.     {
  45.     "HostName": "hostname1",
  46.     "Status": 1,
  47.     "dbpath": "/sequoiadb/database/42000/",
  48.     "Service": [
  49.         {
  50.         "Type": 0,
  51.         "Name": "42000"
  52.         },
  53.         {
  54.         "Type": 1,
  55.         "Name": "42001"
  56.         },
  57.         {
  58.         "Type": 2,
  59.         "Name": "42002"
  60.         }
  61.     ],
  62.     "NodeID": 1003
  63.     }
  64. ],
  65. "GroupID": 1001,
  66. "GroupName": "group1",
  67. "PrimaryNode": 1002,
  68. "Role": 0,
  69. "SecretID": 1425460557,
  70. "Status": 1,
  71. "Version": 7,
  72. "_id": {
  73.     "$oid": "5a045460c517f3cf06a32976"
  74. }
  75. }

其中，节点为：hostname1:40000(备节点，节点位置为1)；hostname1:41000(主节点，节点位置为2)；hostname1:42000(备节点，节点位置为3)；从 group1 分区组中，随机获取位置1和位置2节点中的备节点：

  1. > var rg = db.getRG("group1")
  2. > rg.getSlave(1,2)
  3. hostname1:40000