文档

关于 SequoiaDB

快速入门

快速入门之一键清理

安装

基本操作

数据模型

SQL引擎

FileSystem引擎

S3引擎

系统架构

数据库管理

连接器

驱动

参考手册

SequoiaDB Shell方法

概述

Global

Sdb

SecureSdb

SdbCS

SdbCollection

SdbCursor

SdbQuery

SdbReplicaGroup

SdbNode

SdbDomain

Oma

File

FileContent

Cmd

Remote

Hash

IniFile

Sdbtool

Ssh

System

辅助类型对象

特殊类型对象

操作符

SQL语法

SQL to SequoiaDB 映射表

限制

错误码

故障排除

SAC 管控中心

Web服务

版本信息

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" )
回到顶部