getSlave()

语法

rg.getSlave([positions])

类别

Replica Group

参数

• ( Int32， 选填 )

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

返回值

成功：返回 SdbNode 对象。

Note:

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

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

版本

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

示例

• 获取 group1 分区组的备节点。

• group1 分区组信息如下：

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