如何在 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，它包含了分配给该文档的对象 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 或 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" ] }