renameCS()

语法

db.renameCS( <oldname>, <newname> )

集合空间改名。

参数名	参数类型	描述	是否必填
oldname	字符串	要修改的集合空间名。	是
newname	字符串	集合空间新名字。	是

Note:
改名过程中会阻塞相应数据节点的写操作。
不允许直连数据节点，对集合空间改名。

无返回值，出错抛异常，并输出错误信息。

常见异常如下：

错误码	错误类型	描述	解决方法
-34	SDB_DMS_CS_NOTEXIST	oldname对应的集合空间不存在。	对已存在的集合空间执行rename。
-33	SDB_DMS_CS_EXIST	newname对应的集合空间已存在。	newname设为不存在的名字。
-67	SDB_BACKUP_HAS_ALREADY_START	数据节点正在做备份。	等待备份完成，再执行改名。
-148	SDB_DMS_STATE_NOT_COMPATIBLE	数据节点上有其他rename操作正在执行。	等待其余rename完成，再执行改名。
-149	SDB_REBUILD_HAS_ALREADY_START	数据节点正在做rebuild。	等待rebuild完成，再执行改名。

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

3.0.1及以上版本

对集合空间foo，改名为foo_new 。

 // 连接协调节点
 > db = new Sdb( "localhost", 11810 )
 > db.renameCS( "foo", "foo_new" )