插入

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

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

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

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

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

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

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

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

insert()

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

插入第一个文档

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

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

之后才能做插入操作。

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

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

  1. > db.foo.bar.find()
  2. {
  3. "_id": 1
  4. "name": {
  5. "fist": "Jhon",
  6. "last": "Black"
  7. },
  8. "phone": [
  9. 1853742000,
  10. 1802321000
  11. ]
  12. }

不指定 _id 字段

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

  1. > db.foo.bar.insert( { name: "Tom", age: 20 } )
  2. > db.foo.bar.find()
  3. {
  4. "_id": {
  5. "$oid": "5806c732173d09e66d000001"
  6. },
  7. "name": "Tom",
  8. "age": 20
  9. }

插入多条记录

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

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

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