alter()

名称

alter - 修改域的属性

语法

domain.alter( <options> )

类别

SdbDomain

描述

该函数用于修改域的属性。

Note:

• 删除复制组前必须保证组内不包含任何数据，否则操作将失败。
• 更改 AutoSplit 不会对已存在的集合及集合空间产生影响。

参数

options ( object，必填 )

需要修改的属性列表

• Groups（string/array）：域将包含的所有复制组

  格式：Groups:['group1','group2']

• AutoSplit（boolean）：域是否自动切分

  格式：AutoSplit:true|false

返回值

函数执行成功时，无返回值。

函数执行失败时，将抛异常并输出错误信息。

错误

错误码	可能的原因	解决方法
-154	分区组不存在	使用列表查看分区组是否存在
-214	域不存在	使用 db.listDomains() 查看域是否存在
-256	域已被使用	使用 domain.listCollectionSpaces() 查看域是否存在集合空间

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

版本

v2.0 及以上版本

示例

• 首先创建一个域，包含两个复制组，开启自动切分

> var domain = db.createDomain( 'mydomain', ['group1', 'group2'], { AutoSplit: true } )

• 从域中删除一个复制组 group2，添加另一个复制组 group3，最后域中包含 group1 和 group3 两个复制组

> domain.alter( { Groups: ['group1', 'group3'] } )

• 首先创建一个域，包含一个复制组，复制组中包含表 sample.employee。

> var domain = db.createDomain( 'mydomain', ['group1'] )

• 从域中删除原复制组，添加另一个复制组，将因把拥有数据的 group1 从域中删除而报错

> domain.alter( { Groups: ['group2'] } )
(nofile):0 uncaught exception: -256
Domain has been used