如何在 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" ] }