文档中心

快速入门

安装

基本操作

数据模型

SQL引擎

系统架构

数据库管理

连接器

驱动

参考手册

故障排除

SAC

版本信息

createCS()

语法

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

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

参数描述

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

    属性名 描述 格式
    PageSize 数据页大小。单位为字节,默认值65536。 PageSize: <int32>
    Domain 所属域。 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" } )
回到顶部