getRG - 获取指定复制组
db.getRG(<name>|<id>)
Sdb
该函数用于获取指定复制组。
参数名 | 类型 | 描述 | 是否必填 |
---|---|---|---|
name | string | 复制组名,同一个数据库对象中,复制组名唯一 | name 和 id 任选一个 |
id | number | 复制组 ID,创建复制组时系统自动分配 | id 和 name 任选一个 |
Note:
name 字段的值不能是空串,不能含点(.)或者美元符号($),且长度不超过 127B。
函数执行成功时,将返回一个 SdbReplicaGroup 类型的对象。
函数执行失败时,将抛异常并输出错误信息。
当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。
v2.0 及以上版本
指定 name 值,返回复制组 group1 的引用
> db.getRG("group1")
指定 id 值,返回复制组 group1 的引用(假定 group1 的复制组 ID 为1000)
> db.getRG(1000)