「SequoiaDB巨杉数据库」insert()概述2

参数描述

• 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 的一致。

点击巨杉数据库文档中心了解更多信息