MongoDB - 插入文档

你好，未来的数据库法师们！今天，我们将深入MongoDB的神奇世界，学习如何将文档插入到我们的集合中。如果你是编程新手，不用担心——我会像一位聪明的老法师教年轻的学徒一样，耐心地引导你完成每一步。所以，拿起你的魔杖（或者键盘）让我们开始吧！

MongoDB - Insert Document

理解MongoDB中的文档

在我们跳到插入文档之前，让我们快速回顾一下MongoDB中的文档是什么。将文档想象成一块特殊的羊皮纸，它保存着信息。在麻瓜（非魔法）世界中，我们称这些信息为“数据”。每个文档就像你魔法书中的独特条目，包含关于特定物品或实体的各种细节。

例如，一个关于魔法生物的文档可能看起来像这样：

{
"name": "Dragon",
"type": "Fire-breathing",
"dangerLevel": 10,
"abilities": ["Flying", "Breathing Fire", "Treasure Hoarding"]
}

现在我们理解了什么是文档，让我们学习如何将这些魔法条目添加到我们的MongoDB集合中！

insert() 方法

insert() 方法就像是MongoDB中的“Wingardium Leviosa”咒语——它是向集合中添加文档的基本咒语。然而，就像“Wingardium Leviosa”被更具体的悬浮咒语所取代一样，insert() 方法已经被更精确的方法所取代。但别担心，年轻的法师们，我会教你现代的方法！

insertOne() 方法

当你想要向集合中添加单个文档时，insertOne() 方法非常合适。这就像小心翼翼地将一个珍贵的艺术品放入你的魔法宝库中。

语法

db.collection.insertOne(document)

示例

让我们向我们的“Hogwarts”集合中添加一个新学生：

db.hogwarts.insertOne({
name: "Harry Potter",
house: "Gryffindor",
year: 1,
subjects: ["Potions", "Defense Against the Dark Arts", "Charms"]
})

运行这个咒语（我的意思是，代码）后，MongoDB会将这个文档添加到我们的“Hogwarts”集合中。就这么简单！

理解结果

当你施展insertOne()咒语时，MongoDB不仅仅默默添加文档。它会给你反馈，就像一个魔法镜子显示你咒语的结果。你可能会看到以下内容：

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

acknowledged：这告诉你插入是否成功。true意味着“是的，你的咒语起作用了！”
insertedId：这是你新插入文档的唯一标识符。把它想象成文档的魔法签名。

insertMany() 方法

现在，如果你想要一次性添加多个文档呢？这时insertMany()方法就派上用场了。这就像对一个物体群施放群体悬浮咒！

语法

db.collection.insertMany([document1, document2, ...])

示例

让我们向我们的“Hogwarts”集合中添加多个学生：

db.hogwarts.insertMany([
{
name: "Hermione Granger",
house: "Gryffindor",
year: 1,
subjects: ["Arithmancy", "Muggle Studies", "Ancient Runes"]
},
{
name: "Ron Weasley",
house: "Gryffindor",
year: 1,
subjects: ["Divination", "Care of Magical Creatures"]
},
{
name: "Draco Malfoy",
house: "Slytherin",
year: 1,
subjects: ["Potions", "Dark Arts"]
}
])

这个咒语会将所有三个学生一次性添加到我们的集合中。效率很高，不是吗？

理解结果

施展这个强大的咒语后，MongoDB会再次提供反馈：

{
"acknowledged": true,
"insertedIds": [
ObjectId("60d5ec9d7c213e8456b1b2d5"),
ObjectId("60d5ec9d7c213e8456b1b2d6"),
ObjectId("60d5ec9d7c213e8456b1b2d7")
]
}

acknowledged：再次确认你的咒语是否起作用。
insertedIds：这是一个数组，包含了每个插入文档的唯一标识符。

实用技巧

拼写检查（数据验证）：在插入文档之前总是要双倍检查你的文档。一个拼写错误的字段名可能会导致意外的结果，就像一个发音错误的咒语！
重复键：如果你尝试插入一个与现有文档相同_id的文档，MongoDB将会抛出一个错误。就像尝试注册两个拥有相同魔法签名的学生——这根本行不通！
批量插入：当使用insertMany()时，如果其中一个文档由于（比如）重复键而无法插入，操作将会停止。但是，任何在错误之前插入的文档都会保留在集合中。就像如果一个学生入学考试没通过，其他通过的学生仍然可以进入霍格沃茨！
性能考虑：单次插入文档可能比批量插入要慢。如果你有很多文档要插入，考虑使用insertMany()而不是多个insertOne()调用。

插入方法的总结

这是我们学到的插入方法的快速参考表：

方法	描述	使用场景
`insertOne()`	插入单个文档	当你需要添加一个文档时
`insertMany()`	插入多个文档	当你有一批文档要添加时

记住，年轻的法师们，熟能生巧。不要害怕在你的MongoDB沙盒中尝试这些方法。在你意识到之前，你将能够以一位经验丰富的数据库法师的技巧插入文档！

这就是你在MongoDB文档插入艺术中的第一课。记住，能力越大，责任越大。明智地使用这些咒语，愿你的数据库始终保持有序和高效！

Credits: Image by storyset