如何在 MongoDB 中管理文档

使用 insert() 方法

insert() 方法允许您将一个或多个文档插入到其被调用的集合中。

要插入单个文档，请通过在集合上调用该方法将文档传递给该方法。在这里，我们为名为 Ashley 的学生插入一个新文档

db.students.insert(
    {
        first_name: "Ashley",
        last_name: "Jenkins",
        dob: new Date("January 08, 2003"),
        grade_level: 8
    }
)

WriteResult({ "nInserted" : 1 })

如果您想同时插入多个文档，请传递一个文档数组，而不是将一个文档传递给 insert()。我们可以为名为 Brian 和 Leah 的学生添加两个新文档

db.students.insert(
    [
        {
            first_name: "Brian",
            last_name: "McMantis",
            dob: new Date("September 18, 2010"),
            grade_level: 2
        },
        {
            first_name: "Leah",
            last_name: "Drake",
            dob: new Date("October 03, 2009")
        }
    ]
)

BulkWriteResult({
        "writeErrors" : [ ],
        "writeConcernErrors" : [ ],
        "nInserted" : 2,
        "nUpserted" : 0,
        "nMatched" : 0,
        "nModified" : 0,
        "nRemoved" : 0,
        "upserted" : [ ]
})

由于我们执行了批量写入操作，我们的返回值是 BulkWriteResult，而不是我们之前看到的 WriteResult 对象。

虽然 insert() 方法很灵活，但它已在许多 MongoDB 驱动程序中被弃用，取而代之的是以下两种方法。

使用 insertOne() 方法

insertOne() 方法可用于插入单个文档。与 insert() 方法不同，它一次只能插入一个文档，这使得其行为更具可预测性。

语法与使用 insert() 添加单个文档时相同。我们可以添加另一位名为 Naomi 的学生

db.students.insertOne(
    {
        first_name: "Naomi",
        last_name: "Pyani"
    }
)

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

与 insert() 不同，insertOne() 方法返回一个包含一些额外有用信息的文档。它确认写入已得到集群的确认，并且它包含已分配给文档的对象 ID，因为我们没有提供一个。

使用 insertMany() 方法

为了涵盖您想一次插入多个文档的场景，现在推荐使用 insertMany() 方法。就像使用 insert() 插入多个文档一样，insertMany() 接受一个文档数组。

我们可以添加三位新学生，名为 Jasmine、Michael 和 Toni

db.students.insertMany(
    [
        {
            first_name: "Jasmine",
            last_name: "Took",
            dob: new Date("April 11, 2011")
        },
        {
            first_name: "Michael",
            last_name: "Rodgers",
            dob: new Date("February 25, 2008"),
            grade_level: 6
        },
        {
            first_name: "Toni",
            last_name: "Fowler"
        }
    ]
)

{
        "acknowledged" : true,
        "insertedIds" : [
                ObjectId("60e8792d4655cbf49ff7cb87"),
                ObjectId("60e8792d4655cbf49ff7cb88"),
                ObjectId("60e8792d4655cbf49ff7cb89")
        ]
}

与 insertOne() 一样，insertMany() 返回一个文档，该文档确认写入并提供一个包含已分配给插入文档的 ID 的数组。

更新操作符

在查看每种更新文档的方法之前，我们应该先了解一些可用的更新操作符。

• $currentDate：将字段的值设置为当前日期，可以是日期类型或时间戳类型。
  • 语法：{ $currentDate: { <field>: <type>, ... } }
• $inc：将字段的值增加一个设定量。
  • 语法：{ $inc: { <field>: <amount>, ... } }
• $min：如果指定值小于当前值，则更新字段的值。
  • 语法：{ $min: { <field>: <value>, ... } }
• $max：如果指定值大于当前值，则更新字段的值。
  • 语法：{ $max: { <field>: <value>, ... } }
• $mul：通过将字段值乘以给定数字来更新字段值。
  • 语法：{ $mul: { <field>: <value>, ... } }
• $rename：将字段名称重命名为新标识符。
  • 语法：{ $rename: { <field>: <new_name>, ... } }
• $set：将字段的值替换为给定值。
  • 语法：{ $set: { <field>: value, ... } }
• $setOnInsert：在 upsert 操作期间，如果正在创建新文档，则设置字段的值，否则不执行任何操作。
  • 语法：{ $setOnInsert: { <field>: <value>, ... } }
• $unset：从文档中删除字段。
  • 语法：{ $unset: { <field>: "", ... } }
• $：满足查询的第一个数组元素的占位符。
  • 语法：{ <update_operator>: {<array>.$: <value> } }
• $[]：满足查询的所有数组元素的占位符。
  • 语法：{ <update_operator>: { <array>.$[]: <value> } }
• $addToSet：将值添加到数组，除非它们已经存在。
  • 语法：{ $addToSet: { <field>: <value>, ... } }
• $pop：删除数组的第一个或最后一个元素。
  • 语法：{ $pop: { <field>: (-1 or 1), ... } }
• $pull：删除数组中所有与条件匹配的元素。
  • 语法：{ $pull: { <field>: <condition>, ... } }
• $push：将值附加到数组。
  • 语法：{ $push: { <field>: <value>, ... } }
• $pullAll：从数组中删除所有指定的元素。
  • 语法：{ $pullAll: { <field>: [ <value>, ... ], ...} }
• $each：修改 $addToSet 和 $push 操作符，使它们添加数组的每个元素，而不是将数组作为一个单一元素添加。
  • 语法：{ <update_operator>: { <field>: { $each: [ <value>, ... ] }, ... } }
• $position：与 $each 结合使用，并指定 $push 操作符应该插入的位置。
  • 语法：{ $push: { <field>: { $each: [ <value>, ... ], $position: <num> } } }
• $slice：与 $each 和 $push 结合使用，限制数组中的元素总数。
  • 语法：{ $push: { <field>: { $each: [ <value>, ... ], $slice: <num> } } }
• $sort：与 $each 和 $push 结合使用，对数组元素进行排序。
  • 语法：{ $push: { <field>: { $each: [ <value>, ... ], $sort: <sort_order> } } }

这些不同的更新操作符允许您以不同方式更新文档的各个字段。

更新集合中的单个文档

MongoDB 的 updateOne() 方法用于更新集合中的单个文档。该方法接受两个必需参数以及一个指定可选参数的文档。

第一个参数是一个文档，它指定将用于选择文档的筛选条件。由于 updateOne() 方法最多修改集合中的一个文档，因此将使用满足筛选条件的第一个文档。

第二个参数指定应执行的更新操作。可以在此处指定上面给出的更新操作，以更改匹配文档的内容。

第三个参数是包含各种选项的文档，用于修改该方法的行为。最重要的潜在值是

• upsert：通过在筛选器不匹配任何现有文档时插入新文档，将操作转换为 upsert 过程。
• collation：一个文档，定义应适用于该操作的特定于语言的规则。

例如，我们可以更新单个学生记录，我们通过 _id 字段进行筛选，以确保我们定位到正确的文档。我们可以将 grade_level 设置为新值

db.students.updateOne(
    { _id: ObjectId("60e8792d4655cbf49ff7cb89") },
    { $set: { grade_level: 3 } }
)

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

更新集合中的多个文档

MongoDB 的 updateMany() 方法与 updateOne() 方法类似，但它会更新所有匹配给定筛选器的文档，而不是在第一次匹配后停止。

updateMany() 语法与 updateOne() 语法完全相同，因此唯一的区别是操作的范围。

例如，如果我们想将 teachers 集合文档中的 subjects 数组中所有“composition”的实例更改为“writing”，我们可以使用类似以下的代码

db.teachers.updateMany(
    { subject: "composition" },
    { $set: { "subjects.$": "writing" } }
)

{ "acknowledged" : true, "matchedCount" : 3, "modifiedCount" : 3 }

如果您检查文档，所有“composition”的实例都应该已替换为“writing”

db.teachers.find()

{ "_id" : ObjectId("60eddca65eb74f5c676f3baa"), "first_name" : "Nancy", "last_name" : "Smith", "subjects" : [ "vocabulary", "pronunciation" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bab"), "first_name" : "Ronald", "last_name" : "Taft", "subjects" : [ "literature", "grammar", "writing" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bac"), "first_name" : "Casey", "last_name" : "Meyers", "subjects" : [ "literature", "writing", "grammar" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bad"), "first_name" : "Rebecca", "last_name" : "Carrie", "subjects" : [ "grammar", "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bae"), "first_name" : "Sophie", "last_name" : "Daggs", "subjects" : [ "literature", "writing", "grammar", "vocabulary", "pronunciation" ] }

替换文档

replaceOne() 方法与 updateOne() 方法类似，但它会替换整个文档而不是更新单个字段。语法与前两个命令相同。

例如，如果 Nancy Smith 离开了您的学校，并且您用一位名叫 Clara Newman 的文学教师替换了她，您可以输入以下内容

db.teachers.replaceOne(
    {
        $and: [
            { first_name: "Nancy" },
            { last_name: "Smith" }
        ]
    },
    {
        first_name: "Clara",
        last_name: "Newman",
        subjects: [ "literature" ]
    }
)

{ "acknowledged" : true, "matchedCount" : 1, "modifiedCount" : 1 }

您可以看到匹配的文档已被删除，并且指定的文档已替换它

db.teachers.find()

{ "_id" : ObjectId("60eddca65eb74f5c676f3baa"), "first_name" : "Clara", "last_name" : "Newman", "subjects" : [ "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bab"), "first_name" : "Ronald", "last_name" : "Taft", "subjects" : [ "literature", "grammar", "writing" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bac"), "first_name" : "Casey", "last_name" : "Meyers", "subjects" : [ "literature", "writing", "grammar" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bad"), "first_name" : "Rebecca", "last_name" : "Carrie", "subjects" : [ "grammar", "literature" ] }
{ "_id" : ObjectId("60eddca65eb74f5c676f3bae"), "first_name" : "Sophie", "last_name" : "Daggs", "subjects" : [ "literature", "writing", "grammar", "vocabulary", "pronunciation" ] }