SequoiaDB 简介
安装部署
数据库实例
分布式引擎
SAC 管控中心
参考手册
常见问题及解答(FAQ)
版本信息
createIdIndex - 创建 $id 索引
db.collectionspace.collection.createIdIndex([options])
SdbCollection
该函数用于创建 $id 索引,在 SequoiaDB 中创建集合时可以根据需要将 AutoIndexId 置为 false。这样集合将不会创建默认的“$id”索引,同时数据的更新、删除操作将被禁止。本方法可以恢复“$id”索引,同时开放更新和删除功能。
参数名 | 参数类型 | 默认值 | 描述 | 是否必填 |
---|---|---|---|---|
options | JSON | --- | 可选项 | 否 |
options 参数详细说明如下:
属性名 | 值类型 | 默认值 | 描述 |
---|---|---|---|
SortBufferSize | int | 64 | 创建索引时使用的排序缓存的大小(单位:MB),取值为 0 时表示不使用排序缓存 |
函数执行成功时,无返回值。
函数执行失败时,将抛异常并输出错误信息。
错误码 | 可能的原因 | 解决方法 |
---|---|---|
-247 | $id 索引已经存在 | - |
-291 | 存在一个相同定义的索引 | 删除定义冲突的索引 |
当异常抛出时,可以通过 getLastErrMsg() 获取错误信息或通过 getLastError() 获取错误码。更多错误处理可以参考常见错误处理指南。
v2.0 及以上版本
使用默认参数构建 $id 索引:
> db.sample.employee.createIdIndex()
构建 $id 索引时指定排序缓存大小:
> db.sample.employee.createIdIndex( { SortBufferSize: 128 } )