插入方法
db.collection.insertOne() | 插入单条文档到集合中 |
|---|---|
db.collection.insertMany() | 插入多条文档到集合中 |
db.collection.insert() | 插入单条或多条文档到集合中 |
insertOne() 语法格式
代码语言：javascript复制db.collection.insertOne(
<document>,
{
writeConcern: <document>
}
)只能传一个文档，不能是数组
insertMany() 语法格式
代码语言：javascript复制db.collection.insertMany(
[ <document 1> , <document 2>, ... ],
{
writeConcern: <document>,
ordered: <boolean>
}
)必传一个数组，即使是空数组
insert() 语法格式
代码语言：javascript复制db.collection.insert(
<document or array of documents>,
{
writeConcern: <document>,
ordered: <boolean>
}
)可以传单条文档或者文档数组
writeConcern
看着是一种出错捕捉机制，搞清楚要干嘛再更新吧
ordered
- true：对数组中的文档执行有序插入，其中一个文档发生错误，MongoDB 将返回而不处理数组中的其余文档（默认）
- false：无序插入，其中一个文档发生错误，则继续处理数组中的其他文档
三种 insert 方法的返回内容
代码语言：javascript复制// 插入单条文档
> db.test.insert({})
WriteResult({ "nInserted" : 1 })
// 插入多条文档
> db.test.insert([])
BulkWriteResult({
"writeErrors" : [ ],
"writeConcernErrors" : [ ],
"nInserted" : 0,
"nUpserted" : 0,
"nMatched" : 0,
"nModified" : 0,
"nRemoved" : 0,
"upserted" : [ ]
})
插入操作的重点知识
- MongoDB 向集合里插入记录时，无须事先对数据存储结构进行定义，每个文档的数据结构都可以是不同的
- 如果待插入的集合不存在，则插入操作会默认创建集合
- MongoDB 中，插入操作以单个集合为目标
- MongoDB 中的所有写入操作都是单个文档级别的原子操作
插入不指定 _id 字段的文档
代码语言：javascript复制db.test.insert( { item : "card", qty : 15 })MongoDB 会自动给它分配一个 _id
代码语言：javascript复制db.test.find()
{ "_id" : ObjectId("60b4e2eeec0fd33d89e97a98"), "item" : "card", "qty" : 15 }这些 Objectld 值与执行操作时的机器和时间有关
插入指定 _id 字段的文档
值 _id 必须在集合中唯一，以避免重复键错误
代码语言：javascript复制db.test.insert(
{ _id: 10, item: "box", qty: 20 }
)
db.test.find()
{ "_id" : 10, "item" : "box" , "qty": 20 } 可以看到新插入文档的 id 值为设置的 id 值
插入文档数组
插入的多个文档无须具有相同的字段
代码语言：javascript复制db.test1.insert(
[
{ _id: 11, item: "pencil", qty: 50, type: "no.2" },
{ item: "pen", qty: 20 },
{ item: "eraser", qty: 25 }
]
)- 的第一个文档包含一个 _id 字段和一个 type 字段
- 第二个和第三个文档不包含 _id 字段
- 因此，在插入过程中，MongoDB 将会为第二个和第三个文档创建默认 _id 字段
db.test1.find()
{ "_id" : 11, "item" : "pencil", "qty" : 50, "type" : "no.2" }
{ "_id" : ObjectId("60b4e98fec0fd33d89e97a99"), "item" : "pen", "qty" : 20 }
{ "_id" : ObjectId("60b4e98fec0fd33d89e97a9a"), "item" : "eraser", "qty" : 25 }无序插入
代码语言：javascript复制db.products.insert(
[
{ _id: 20, item: "lamp", qty: 50, type: "desk" },
{ _id: 21, item: "lamp", qty: 20, type: "floor" },
{ _id: 22, item: "bulk", qty: 100 }
],
{ ordered: false }
)如果在插入其中一个文档期间发生错误，MongoDB 会继续将其余文档插入数组中
还有其他插入文档的方法
需要添加 upsert: true 选项
db.collection.update()db.collection.updateOne()db.collection.updateMany()db.collection.findAndModify()db.collection.findOneAndUpdate()db.collection.findOneAndReplace()
不需要添加也可以插入文档
db.collection.save()db.collection.bulkWrite()
