名称
createCL - 创建一个新的集合。
语法
db.collectionspace.createCL(<name>,[options])
类别
Collection Space
描述
在指定集合空间下创建集合（Collection），集合是数据库中存放文档记录的逻辑对象，任何一条文档记录必须属于一个且仅属于一个集合。
参数
-
name( String， 必填 )集合名，在同一个集合空间中，集合名必须唯一。
-
options( Object， 选填 )在创建集合时，可以通过
options参数设置集合的其他属性，如指定集合的分区键，是否以压缩的形式插入数据等。可组合使用options的如下选项：-
ShardingKey( Object )：分区键。格式：
ShardingKey:{<字段1> : <1|-1>,[<字段2> : <1|-1>, ...]} -
ShardingType( String )：分区方式。默认为 hash 分区。其可选取值如下：扫描二维码关注公众号，回复： 12185456 查看本文章
- "hash"：hash 分区。
- "range"：范围分区。
格式：
ShardingType:"hash"|"range" -
Partition( Int32 )：分区数。仅当选择 hash 分区时填写，代表了 hash 分区的个数。其值必须是2的幂。范围在[2^3，2^20]。默认为4096。格式：
Partition: <分区数> -
ReplSize( Int32 )：写操作需同步的副本数。默认值为1。其可选取值如下：- -1：表示写请求需同步到该复制组若干活跃的节点之后，数据库写操作才返回应答给客户端。
- 0：表示写请求需同步到该复制组的所有节点之后，数据库写操作才返回应答给客户端。
- 1 - 7：表示写请求需同步到该复制组指定数量个节点之后，数据库写操作才返回应答给客户端。
格式：
ReplSize: <num> -
Compressed( Bool )：标示新集合是否开启数据压缩功能。默认为 true。格式：
Compressed:true|false -
CompressionType( String )：压缩算法类型。默认为 lzw 算法。其可选取值如下：- "snappy"：使用 snappy 算法压缩。
- "lzw"：使用 lzw 算法压缩。
格式：
CompressionType:"snappy"|"lzw" -
IsMainCL( Bool )：标示新集合是否为主分区集合，默认为 false。格式：
IsMainCL:true|false -
AutoSplit( Bool )：标示新集合是否开启自动切分功能，默认为 false。格式：
AutoSplit:true|false -
Group( String )：指定新集合将被创建到哪个复制组。格式：
Group:<group name> -
AutoIndexId( Bool )：标示新集合是否自动使用_id字段创建名字为"$id"的唯一索引，默认为 true。格式：
AutoIndexId:true|false -
EnsureShardingIndex( Bool )：标示集合是否自动使用ShardingKey包含的字段创建名字为"$shard"的索引，默认为true。格式：
EnsureShardingIndex:true|false -
StrictDataMode( Bool )：标示对该集合的操作是否开启严格数据类型模式，默认为false(不开启)。严格数据模式的开启标示对数值操作存在以下限制：- 运算过程不改数据类型；
- 数值运算出现溢出时直接报错，错误码SDB_VALUE_OVERFLOW；
格式：
StrictDataMode:true|false -
AutoIncrement( Object )：自增字段格式：
AutoIncrement:{Field: <字段>, ...}或AutoIncrement:[ {Field: <字段1>, ...}, {Field: <字段2>, ...}, ... ]例子：
AutoIncrement: { Field: "userID", Generated: "always" }- 参数详情可参考自增字段介绍
-
LobShardingKeyFormat( String )：指定大对象生成主表切分键键值的格式。目前支持将大对象ID中的时间属性转换成如下字符串形式：- "YYYYMMDD"：将大对象ID的时间属性转换为年月日的字符串形式，如"20190701"。
- "YYYYMM"：将大对象ID的时间属性转换为年月的字符串形式，如"201907"。
- "YYYY"：将大对象ID的时间属性转换为年的字符串形式，如"2019"。
格式：
LobShardingKeyFormat:"YYYYMMDD"|"YYYYMM"|"YYYY"
-
Note:
集合名限制请参考限制
当参数
options内设置了多个参数时，需用英文半角的逗号","将各参数的取值隔开。在创建集合空间时，可以指定所属的数据域。创建集合时，使用 Group 参数，指定的复制组必须在域内；不使用 Group 参数，集合将被创建在域的任意一个复制组上。
创建集合的 AutoSplit 参数比数据域的 AutoSplit 属性优先级更高。
AutoSplit 不能与 Group 参数同时使用。
AutoSplit 必须配合散列分区使用。
压缩算法选择策略：snappy 压缩算法是以单条记录为单位进行压缩，记录内部的数据重复度直接影响到压缩率。因此，当记录内部数据重复度较高，如每条记录的字段名、字段值相似，使用 snappy 算法可获得良好的压缩性能。如果记录内部数据重复度很低，但记录间具有更高的相似性，如不同记录之间有相同的字段名，相近的字段值等，则使用 lzw 算法更优。
LobShardingKeyFormat 只能在主表中使用，同时要求切分键只能有一个切分字段。
了解更多内容请点击巨杉数据库官网