文档

关于 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服务

版本信息

createCS()

语法

db.createCS( <name>, [options] )

在数据库对象中创建集合空间。

参数描述

参数名 参数类型 描述 是否必填
name string 集合空间名,同一个数据库对象中,集合空间名必须唯一。
options Json Json对象,集合空间可选属性。
  1. options 格式

    属性名 描述 格式
    PageSize 数据页/索引页大小。单位为字节,默认值65536。 PageSize: <int32>
    Domain 所属域。默认值系统域 SYSDOMAIN,SYSDOMAIN 包含所有的复制组。 Domain: <string>
    LobPageSize Lob数据页大小。单位为字节,默认值262144。 LobPageSize: <int32>

Note:

  • name 字段的值不能是空串,不能含点(.)或者美元符号($),且长度不超过127B。
  • 同一个数据库对象集合空间名必须唯一。
  • 在创建集合空间时用户可以指定数据页大小,指定后不可更改。如果不指定默认为65536B。
  • PageSize 只能选填0,4096,8192,16384,32768,65536之一,0即为默认值65536。
  • 所属域必须已经存在,且不能指定为系统域 SYSDOMAIN。
  • 为兼容较早版本接口,db.createCS( <name>, [PageSize] ) 同样可以工作。
  • LobPageSize只能选填0,4096,8192,16384,32768,65536,131072,262144,524288之一,0即为默认值262144。

返回值

返回新建集合空间的引用,出错抛异常,并输出错误信息,可以通过 getLastErrMsg() 获取错误信息 或 通过 getLastError() 获取错误码。关于错误处理可以参考常见错误处理指南

示例

  • 创建名为 foo 的集合空间,不指定数据页大小,即数据页大小为默认值65536B

    > db.createCS( "foo" )
  • 创建名为 foo 的集合空间,指定数据页大小为4096B,所属域为“mydomain”

    > db.createCS( "foo", { PageSize: 4096, Domain: "mydomain" } )
回到顶部