getRG()

语法

db.getRG( <name> | <id> )

获取指定分区组。

参数描述

参数名参数类型描述是否必填
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 )