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

返回值

• 成功返回详细结果信息（BSONObj 对象），结构如下：

{
    InsertedNum    : <INT32>  成功插入的记录数，不包含替代和忽略的记录,
    DuplicatedNum  : <INT32>  因重复键冲突被忽略或替代的记录数
}

• 当用户开启 flag 参数的 SDB_INSERT_RETURN_ID 选项或者 options 参数的 ReturnOID 选项时，详细结果信息中还包含 "_id" 字段，情况如下：

  • 单条插入：直接返回插入记录的“_id”字段的内容。
  • 批量插入：以数组的方式返回插入记录的“_id”字段的内容。

• 出错抛异常。

错误

insert()函数常见异常如下：

当异常抛出时，可以通过getLastError()获取错误码， 或通过getLastErrMsg()获取错误信息。 可以参考常见错误处理指南了解更多内容。

版本

v1.0及以上版本。

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