• 插入
    • insert()
      • 插入第一个文档
      • 不指定 _id 字段
      • 插入多条记录

    插入

    在 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 } ] )