getRG()

语法

db.getRG( | )

获取指定分区组。

参数描述

参数名参数类型描述是否必填
namestring分区组名,同一个数据库对象中,分区组名唯一。name 和 id 任选一个
idint分区组 id,创建分区组时系统自动分配。id 和 name 任选一个

Note:

  • name 字段的值不能使空串,不能含点(.)或者美元符号($),且长度不超过127B。

返回值

返回指定分区组的引用,出错抛异常,并输出错误信息,可以通过 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。关于错误处理可以参考常见错误处理指南

示例

  • 指定 name 值,返回分区组 group1 的引用

    1. > db.getRG( "group1" )
  • 指定 id 值,返回分区组 group1 的引用(假定 group1 的分区组 id 为1000)

    1. > db.getRG( 1000 )