- 插入
- insert()
- 插入第一个文档
- 不指定 _id 字段
- 插入多条记录
- insert()
插入
在 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 } ] )