mongodb基础操作之insert插入操作
mongodb insert 操作分为四种:insert、save、insertOne、insertMany,下面讲依次介绍四种操作的详细api操作及区别。
注意:插入过程中,如果没有指定 _id,那么 MongoDB 会自动的为其生成一个;插入成功以后,将会返回一个 document,其中包含了当前成功插入的 document 的 _id。
1. insert
说明:
将单个或多个文档插入到集合中
语法:
db.collection.insert(
<document or array of documents>,
{
writeConcern: <document>,
ordered: <boolean>
}
)
参数讲解:
document:要插入的文档,必填参数
writeConcern:该参数是可选的,表达写作关注的文件忽略使用默认的写关注点,在后面介绍到mongodb的高级知识-副本集群中会详细介绍演示该参数。
ordered:该参数是可选的。一个布尔值,指定mongod实例应执行有序插入还是无序插入。默认为true,在分片集合上执行有序的操作列表通常比执行无序列表要慢,因为对于有序列表,每个操作都必须等待前一个操作完成
1.1. 示例
db.insertExample.insert(
[
{ _id: 11, item: "pencil", qty: 50, type: "no.2" },
{ item: "pen", qty: 20 },
{ item: "eraser", qty: 25 }
]
)
返回结果:
{ acknowledged: 1,
insertedIds:
{ '0': 11,
'1':
{ _bsontype: 'ObjectID',
id: ObjectId("5fbb92ad4906484955bb1bfa")
'2':
{ _bsontype: 'ObjectID',
id: ObjectId("5fbb92ad4906484955bb1bfb")
}
2. save
说明:
更新现有文档或插入新文档,具体取决于文档参数。save()方法使用insert或update命令,如果文档不包含_id字段,那么save()方法调用insert()方法。在操作期间,mongo shell将创建一个ObjectId并将其分配给_id字段。如果文档包含_id字段,那么save()方法等价于upsert选项设置为true和_id字段上的查询文档的更新。
语法:
db.collection.save(
<document>,
{
writeConcern: <document>
}
)
参数讲解:
document:要保存到集合中的文档。
writeConcern:可选的。表达编写关注点的文档。省略以使用默认的写关注点,
如果在事务中运行,不要显式地设置操作的写关注。若要对事务使用写关注,请参见读关注/写关注/读首选项,在后面介绍到mongodb的高级知识-副本集群中会详细介绍演示该参数。
2.1. 示例
db.saveExample.save( { item: "book", qty: 40 } )
返回结果:
{ "_id" : ObjectId("5fe3082595b782487444fa0f"), "item" : "book", "qty" : 40 }
更新qty为30,item为water
db.saveExample.save( { _id: ObjectId("5fe3082595b782487444fa0f"), item: "water", qty: 30 } )
返回结果:
{ "_id" : ObjectId("5fe3082595b782487444fa0f"), "item" : "water", "qty" : 30 }
3. insertOne
说明:
将单个文档插入到集合中
语法:
db.collection.insertOne(
{<document>},
{
writeConcern: <document>
})
参数讲解:
document:要插入的文档,必填参数
writeConcern:该参数是可选的,表达写作关注的文件忽略使用默认的写关注点,在后面介绍到mongodb的高级知识-副本集群中会详细介绍演示该参数。
3.1. 示例
db.insertOneExample.insertOne(
{ "item": "envelopes", "qty": 100, type: "Self-Sealing" },
{ writeConcern: { w : "majority", wtimeout : 100 } }//给定一个三个成员的副本集,下面的操作指定w占多数,wtimeout为100毫秒:
);
4. insertMany
说明:
将多个文档插入到集合中【每个组中的操作数不能超过maxWriteBatchSize数据库的值。从MongoDB 3.6开始,此值为100,000。该值显示在该isMaster.maxWriteBatchSize字段中,查看maxWriteBatchSize值命令:db.runCommand({"isMaster":1})】
语法:
db.collection.insertMany(
[ <document 1> , <document 2>, ... ],
{
writeConcern: <document>,
ordered: <boolean>
}
)
参数讲解:
document:要插入的文档,必填参数
writeConcern:该参数是可选的,表达写作关注的文件忽略使用默认的写关注点,在后面介绍到mongodb的高级知识-副本集群中会详细介绍演示该参数。
ordered:该参数是可选的。一个布尔值,指定mongod实例应执行有序插入还是无序插入。默认为true,在分片集合上执行有序的操作列表通常比执行无序列表要慢,因为对于有序列表,每个操作都必须等待前一个操作完成,在顺序写入时,一旦遇到错误,操作便会停止,剩余的文档无论正确与否,都不会被写入
4.1. 示例
db.insertManyExample.insertMany( [
{ _id: 10, item: "large box", qty: 20 },
{ _id: 11, item: "medium box", qty: 30 },
{ _id: 12, item: "envelope", qty: 100},
{ _id: 13, item: "tape", qty: 20},
{ _id: 14, item: "bubble wrap", qty: 30}
], { ordered: false} );