MongoDB 插入文档

本章节中我们将向大家介绍如何将数据插入到 MongoDB 的集合中。

文档的数据结构和 JSON 基本一样。

所有存储在集合中的数据都是 BSON 格式。

BSON 是一种类似 JSON 的二进制形式的存储格式，是 Binary JSON 的简称。

常用的插入文档方法包括： db.collection.insertOne()：插入单个文档 db.collection.insertMany()：插入多个文档 db.collection.save()：类似于 insertOne()。如果文档存在，则该文档会被更新；如果文档不存在，则会插入一个新文档。

1、insertOne()

insertOne() 方法用于在集合中插入单个文档。

db.collection.insertOne(document, options)

document：要插入的单个文档。 options（可选）：一个可选参数对象，可以包含 writeConcern 和 bypassDocumentValidation 等。

实例

db.myCollection.insertOne({
    name: "Alice",
    age: 25,
    city: "New York"
});

返回结果：

{
    "acknowledged": true,
    "insertedId": ObjectId("60c72b2f9b1d8b5a5f8e2b2d")
}

2、insertMany()

insertMany() 方法用于在集合中插入多个文档。

db.collection.insertMany(documents, options)

documents：要插入的文档数组。 options（可选）：一个可选参数对象，可以包含 ordered、writeConcern 和 bypassDocumentValidation 等。

db.myCollection.insertMany([
    { name: "Bob", age: 30, city: "Los Angeles" },
    { name: "Charlie", age: 35, city: "Chicago" }
]);

返回结果：

{
    "acknowledged": true,
    "insertedIds": [
        ObjectId("60c72b2f9b1d8b5a5f8e2b2e"),
        ObjectId("60c72b2f9b1d8b5a5f8e2b2f")
    ]
}

3、db.collection.save()

save() 方法在插入文档时表现得类似于 insertOne()。

如果文档包含 _id 字段且已存在，则该文档会被更新；如果文档不包含 _id 字段或 _id 不存在，则会插入一个新文档。

db.collection.save(document, options)

document：要保存的文档。 options（可选）：一个可选参数对象，可以包含 writeConcern 等。

db.myCollection.save({
    _id: ObjectId("60c72b2f9b1d8b5a5f8e2b2d"),
    name: "David",
    age: 40,
    city: "San Francisco"
});

插入文档时的选项

这些方法的 options 参数通常可以包含以下选项：

ordered（仅适用于 insertMany）：布尔值。如果为 true，则按顺序插入文档，在遇到错误时停止；如果为 false，则尝试插入所有文档，即使遇到错误也继续。默认值为 true。 writeConcern：指定写操作的确认级别。 bypassDocumentValidation：布尔值。如果为 true，则忽略集合的文档验证规则。

实例

插入单个文档：

db.myCollection.insertOne({
    name: "Alice",
    age: 25,
    city: "New York"
});

插入多个文档：

db.myCollection.insertMany([
    { name: "Bob", age: 30, city: "Los Angeles" },
    { name: "Charlie", age: 35, city: "Chicago" }
]);

保存文档：

db.myCollection.save({
    _id: ObjectId("60c72b2f9b1d8b5a5f8e2b2d"),
    name: "David",
    age: 40,
    city: "San Francisco"
});

通过这些方法，你可以灵活地将文档插入到 MongoDB 集合中，以满足各种应用场景的需求。

以下文档可以存储在 MongoDB 的 runoob 数据库 的 col 集合中：

>db.col.insert({title: 'MongoDB 教程', 
    description: 'MongoDB 是一个 Nosql 数据库',
    by: '菜鸟教程',
    url: 'http://www.runoob.com',
    tags: ['mongodb', 'database', 'NoSQL'],
    likes: 100
})

以上实例中 col 是我们的集合名，如果该集合不在该数据库中， MongoDB 会自动创建该集合并插入文档。

查看已插入文档：

> db.col.find()
{ "_id" : ObjectId("56064886ade2f21f36b03134"), "title" : "MongoDB 教程", "description" : "MongoDB 是一个 Nosql 数据库", "by" : "菜鸟教程", "url" : "http://www.runoob.com", "tags" : [ "mongodb", "database", "NoSQL" ], "likes" : 100 }
> 

我们也可以将数据定义为一个变量，如下所示：

> document=({title: 'MongoDB 教程', 
    description: 'MongoDB 是一个 Nosql 数据库',
    by: '菜鸟教程',
    url: 'http://www.runoob.com',
    tags: ['mongodb', 'database', 'NoSQL'],
    likes: 100
});

执行后显示结果如下：

{
        "title" : "MongoDB 教程",
        "description" : "MongoDB 是一个 Nosql 数据库",
        "by" : "菜鸟教程",
        "url" : "http://www.runoob.com",
        "tags" : [
                "mongodb",
                "database",
                "NoSQL"
        ],
        "likes" : 100
}

执行插入操作：

> db.col.insert(document)
WriteResult({ "nInserted" : 1 })
> 

插入文档你也可以使用 db.col.save(document) 命令。如果不指定 _id 字段 save() 方法类似于 insert() 方法。如果指定 _id 字段，则会更新该 _id 的数据。