如何在 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() 方法返回一个包含一些额外有用信息的文档。它确认写入已得到集群的确认，并且它包含分配给文档的 ObjectID，因为我们没有提供一个。

使用 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" ] }