插入

在 SequoiaDB 中，insert 操作是向集合中添加新的文档记录。我们可以使用insert() 方法向 SequoiaDB 中的集合中添加记录。

Note: 本文档的所有例子都是使用 SequoiaDB 的 shell 接口。

所有的插入操作在 SequoiaDB 中具有如下性质：

• 如果插入的文档记录没有 _id 字段，客户端将会为记录自动添加 _id 字段，并且填充一个唯一值。

• 如果指定 _id 字段，那么在集合中 _id 的值必须唯一；否则出现操作异常。

• 最大的 BSON 文档长度为16MB。

• 文档结构的字段命名有如下限制：

  字段名 _id作为主键保存在集合中，它的值必须唯一且不可改变，它的值可以是除数组类型以外的其他任何类型。字段的命名不能是空串；不能以$开始；不能含有（.）。

insert()

insert() 是向SequoiaDB 集合中插入记录的主要方法。

插入第一个文档

如果集合空间和集合不存在，可以使用如下命令进行创建集合空间和集合：

> var db = new Sdb("localhost", 11810)
> db.createCS("foo")
> db.foo.createCL("bar")

之后才能做插入操作。

> db.foo.bar.insert( { _id: 1, name: { fist: "Jhon", last: "Black" }, phone: [ 1853742000, 1802321000 ] } )

可以使用 find() 方法确认是否插入成功。

> db.foo.bar.find()
{
  "_id": 1
  "name": {
    "fist": "Jhon",
    "last": "Black"
  },
  "phone": [
    1853742000,
    1802321000
  ]
}

不指定 _id 字段

如果新的文档记录不包含 _id字段，insert 方法会自动向文档添加 _id 字段并生成一个唯一的 $oid 值

> db.foo.bar.insert( { name: "Tom", age: 20 } )
> db.foo.bar.find()
{
  "_id": {
    "$oid": "5806c732173d09e66d000001"
  },
  "name": "Tom",
  "age": 20
}

插入多条记录

如果向 insert 方法中传一个数组类型的文档，insert()方法将会在集合中执行批量插入。

下面的操作是向集合 bar 中插入两条记录。此操作也说明了 SequoiaDB的动态模式的特点。尽管 _id:20 的记录含有字段名 phone 而在另一条记录中不存在，SequoiaDB 不要求其他记录必须含有此字段。

> db.foo.bar.insert( [ { name: "Mike", age: 15 }, { _id: 20, name: "John", age: 25, phone: 123 } ] )