参数描述
-
doc|docs
( Object|Object of Array, 必填 )单条或者批量记录。
-
flag
( Int, 选填 )插入标志位,用于控制插入操作的行为及结果。其默认值为 0。可单独使用或者通过“位与”的方式使用如下选项来控制插入操作的行为及结果:
- SDB_INSERT_RETURN_ID:表示插入成功后返回记录中“_id”字段的内容。
- SDB_INSERT_CONTONDUP:默认情况下,当发生索引键冲突时,插入操作将失败并且终止。设置该选项后,当发生索引键冲突时,跳过该条记录并继续插入其他记录。
- SDB_INSERT_REPLACEONDUP:默认情况下,当发生索引键冲突时,插入操作将失败并且终止。设置该选项后,当发生索引键冲突时,将已存在的记录更新为待插入的新记录,并继续插入其他记录。
-
options
( Object, 选填 )插入选项,用于控制插入操作的行为及结果。参数
options
等同于参数flag
,其属性选项如下:ReturnOID
( Bool, 选填 ):等同于参数flag
中的 SDB_INSERT_RETURN_ID 选项。ContOnDup
( Bool, 选填 ):等同于参数flag
中的 SDB_INSERT_CONTONDUP 选项。ReplaceOnDup
( Bool, 选填 ):等同于参数flag
中的 SDB_INSERT_REPLACEONDUP 选项。
Note:
-
当插入的记录不包含 “_id” 字段时,SequoiaDB 会自动为记录添加一个 “_id” 字段来唯一标识该记录。
-
参数
flag
中的 SDB_INSERT_CONTONDUP 和 SDB_INSERT_REPLACEONDUP 选项不能同时组合使用。使用参数options
时的情况与使用参数flag
的一致。
点击巨杉数据库文档中心了解更多信息