在本章节中，我们将深入探讨如何在 MongoDB 中插入文档。我们将涵盖基本的插入操作，以及如何使用不同的方法来优化插入性能和处理错误。
插入单个文档
在 MongoDB 中插入单个文档是通过 insertOne() 方法实现的。这个方法接收一个 JSON 样式的文档作为参数，并将其保存到指定的集合中。
基本示例
假设我们有一个名为 users 的集合，我们想要向其中添加一个新用户：
db.users.insertOne({
name: "张三",
age: 25,
email: "zhangsan@example.com"
});在这个例子中，我们创建了一个新的文档，包含了用户的姓名、年龄和电子邮件地址，并将它插入到了 users 集合中。
处理插入结果
insertOne() 方法返回一个对象，该对象包含有关插入操作的信息，包括是否成功插入了文档以及插入文档的 _id。我们可以检查这些信息来确认操作的结果：
const result = db.users.insertOne({
name: "李四",
age: 30,
email: "lisi@example.com"
});
console.log(result);输出结果可能如下所示：
{
"acknowledged" : true,
"insertedId" : ObjectId("5f9d3a7b9c4d6e1234567890")
}这里，acknowledged 属性表示操作是否被服务器成功接收，而 insertedId 则是新插入文档的 _id。
批量插入文档
当需要插入多个文档时，可以使用 insertMany() 方法。这比多次调用 insertOne() 更高效，因为它减少了与数据库通信的次数。
示例代码
假设我们需要向 users 集合中插入多个用户：
// www.javascriptcn.com code example
db.users.insertMany([
{
name: "王五",
age: 22,
email: "wangwu@example.com"
},
{
name: "赵六",
age: 28,
email: "zhaoliu@example.com"
}
]);上述代码将会向 users 集合中添加两个新的文档。
错误处理
在执行批量插入时，可能会遇到一些问题，比如某些文档违反了唯一性约束。在这种情况下，insertMany() 方法会抛出异常。为了避免这种情况，可以设置 ordered: false 参数，这样即使某些文档插入失败，其他文档仍然可以被插入：
// www.javascriptcn.com code example
db.users.insertMany([
{
name: "孙七",
age: 33,
email: "sunqi@example.com"
},
{
name: "周八",
age: 35,
email: "zhouba@example.com"
},
{
name: "吴九", // 注意：name 字段已经存在，会导致插入失败
age: 29,
email: "wujiu@example.com"
}
], { ordered: false });通过这种方式，如果 孙七 和 周八 成功插入，但 吴九 因为重复的 name 字段无法插入，那么 吴九 将不会阻止其他文档的成功插入。
使用事务进行安全插入
在某些场景下，为了确保数据的一致性和完整性，可能需要使用事务来进行插入操作。MongoDB 支持多文档事务，这使得在插入文档时可以保持操作的原子性。
开始一个事务
首先，你需要开始一个新的事务：
session.startTransaction({
readConcern: { level: "snapshot" }, // 可选：设置读取关注级别
writeConcern: { w: "majority" } // 可选：设置写入关注级别
});插入文档
接着，在事务中插入文档：
db.users.insertOne({ name: "郑十", age: 31, email: "zhengshi@example.com" }, { session });提交事务
最后，提交事务以完成所有操作：
session.commitTransaction();
如果在事务过程中遇到任何错误，你可以选择回滚事务以恢复到事务开始前的状态：
try {
session.commitTransaction();
} catch (error) {
session.abortTransaction();
}以上就是在 MongoDB 中插入文档的基本方法和最佳实践。理解这些概念将帮助你有效地管理和操作你的数据。