• createCS()
    • 语法
    • 参数描述
    • 返回值
    • 示例

    createCS()

    语法

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

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

    参数描述

    参数名参数类型描述是否必填
    namestring集合空间名，同一个数据库对象中，集合空间名必须唯一。是
    optionsJsonJson对象，集合空间可选属性。否
    • options 格式

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

    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
    1. > db.createCS( "foo" )
    • 创建名为 foo 的集合空间，指定数据页大小为4096B，所属域为“mydomain”
    1. > db.createCS( "foo", { PageSize: 4096, Domain: "mydomain" } )