mongodb升级版本 强制 mongodb更新文档

本篇我们将会介绍如何使用集合的 updateOne() 和 updateMany() 方法更新文档。

updateOne() 方法

updateOne() 方法可以更新满足条件的单个文档，语法如下：

db.collection.updateOne(filter, update, options)

其中，

• filter 用于指定一个查询条件。如果多个文档都满足条件，updateOne() 只会更新第一个满足条件的文档。如果指定一个空文档（{}）作为查询条件，updateOne() 将会更新集合中返回的第一个文档。
• update 用于指定更新操作。
• options 参数用于指定一些更新选项，本文不涉及相关内容。

updateOne() 方法将会返回一个结果文档，包括但不限于以下字段：

• matchedCount 字段返回了满足条件的文档数量。
• modifiedCount 字段返回了被更新的文档数量。对于 updateOne() 方法，结果为 0 或者 1。

$set 操作符

$set 操作符用于替换指定字段的值，语法如下：

{ $set: { <field1>: <value1>, <field2>: <value2>, ...}}

如果指定的字段不存在，$set 操作符将会为文档增加一个新的字段，只要新的字段不违法类型约束。

如果指定字段时使用了点符合，例如 embededDoc.field，同时字段 field 不存在，$set 操作符将会创建一个嵌入式文档。

updateOne() 示例

接下来的示例将会使用以下 products 集合：

db.products.insertMany([
    { "_id" : 1, "name" : "xPhone", "price" : 799, "releaseDate": ISODate("2011-05-14"), "spec" : { "ram" : 4, "screen" : 6.5, "cpu" : 2.66 },"color":["white","black"],"storage":[64,128,256]},
    { "_id" : 2, "name" : "xTablet", "price" : 899, "releaseDate": ISODate("2011-09-01") , "spec" : { "ram" : 16, "screen" : 9.5, "cpu" : 3.66 },"color":["white","black","purple"],"storage":[128,256,512]},
    { "_id" : 3, "name" : "SmartTablet", "price" : 899, "releaseDate": ISODate("2015-01-14"), "spec" : { "ram" : 12, "screen" : 9.7, "cpu" : 3.66 },"color":["blue"],"storage":[16,64,128]},
    { "_id" : 4, "name" : "SmartPad", "price" : 699, "releaseDate": ISODate("2020-05-14"),"spec" : { "ram" : 8, "screen" : 9.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256,1024]},
    { "_id" : 5, "name" : "SmartPhone", "price" : 599,"releaseDate": ISODate("2022-09-14"), "spec" : { "ram" : 4, "screen" : 5.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256]}
 ])

示例一：更新单个文档

以下示例使用 updateOne() 方法更新 _id 等于 1 的文档中的 price 字段：

db.products.updateOne({
    _id: 1
}, {
    $set: {
        price: 899
    }
})

其中，

• { _id : 1 } 是查找文档的条件。
• { $set: { price: 899 } } 指定了更新操作，利用 $set 操作符将 price 字段修改为 899。

示例返回的结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

在返回结果中，matchedCount 代表了满足查询条件的文档数量（1），modifiedCount 代表了被修改的文档数量（1）。

我们可以使用 findOne() 方法验证修改后的文档内容：

db.products.findOne({ _id: 1 }, { name: 1, price: 1 })

{ _id: 1, name: 'xPhone', price: 899 }

示例二：更新第一个匹配的文档

以下查询返回了价格等于 899 的所有产品：

db.products.find({ price: 899 }, { name: 1, price: 1 })

[
  { _id: 1, name: 'xPhone', price: 899 },
  { _id: 2, name: 'xTablet', price: 899 },
  { _id: 3, name: 'SmartTablet', price: 899 }
]

以下示例使用 updateOne() 方法更新价格等于 899 的第一个文档：

db.products.updateOne({ price: 899 }, { $set: { price: null } })

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

按照默认的返回顺序，第一个价格等于 899 的产品 _id 等于 1，它的价格被更新为 null：

db.products.find({ _id: 1}, { name: 1, price: 1 })

[ { _id: 1, name: 'xPhone', price: null } ]

示例三：更新嵌入式文档

以下查询返回了 _id 等于 4 的文档：

db.products.find({ _id: 4 }, { name: 1, spec: 1 })

[
  {
    _id: 4,
    name: 'SmartPad',
    spec: { ram: 8, screen: 9.7, cpu: 1.66 }
  }
]

下面的示例使用 updateOne() 方法更新该文档中的嵌入式文档 spec 的 ram、screen 以及 cpu 字段：

db.products.updateOne({
    _id: 4
}, {
    $set: {
        "spec.ram": 16,
        "spec.screen": 10.7,
        "spec.cpu": 2.66
    }
})

操作返回的结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

再次查询文档中的内容：

db.products.find({ _id: 4 }, { name: 1, spec: 1 })

[
  {
    _id: 4,
    name: 'SmartPad',
    spec: { ram: 16, screen: 10.7, cpu: 2.66 }
  }
]

示例四：更新数组元素

以下示例使用 updateOne() 方法更新文档（_id: 4）中数组字段 storage 的第一个和第二个元素：

db.products.updateOne(
 { _id: 4}, 
 {
    $set: {
        "storage.0": 16,
        "storage.1": 32
    }
 }
)

返回结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}

再次查询该文档中的内容：

db.products.find({ _id: 4 }, { name: 1, storage: 1 });

[ { _id: 4, name: 'SmartPad', storage: [ 16, 32, 1024 ] } ]

updateMany() 方法

updateMany() 方法可以更新满足条件的所有文档，语法如下：

db.collection.updateMany(filter, update, options)

其中，

• filter 用于指定一个查询条件。如果指定一个空文档（{}）作为查询条件，将会更新集合中的全部文档。
• update 用于指定更新操作。
• options 参数用于指定一些更新选项，本文不涉及相关内容。

updateMany() 方法将会返回一个结果文档，包括但不限于以下字段：

• matchedCount 字段返回了满足条件的文档数量。
• modifiedCount 字段返回了被更新的文档数量。

updateMany() 同样使用 $set 操作符执行更新操作。

updateMany() 示例

示例一：更新多个文档

以下示例使用 updateMany() 方法更新价格为 899 的所有产品：

db.products.updateMany(
    {  price: 899}, 
    { $set: {  price: 895 }}
)

其中，

• { price : 899 } 指定了查找文档的条件。
• { $set: { price: 895} } 指定了更新操作，利用 $set 操作符将 price 字段修改为 895。

查询返回的结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 2,
  modifiedCount: 2,
  upsertedCount: 0
}

在返回结果中，matchedCount 代表了满足查询条件的文档数量（2），modifiedCount 代表了被更新的文档数量（2）。

再次通过价格（895）查询产品：

db.products.find({
    price: 895
}, {
    name: 1,
    price: 1
})

查询返回的结果如下：

[
  { _id: 2, name: 'xTablet', price: 895 },
  { _id: 3, name: 'SmartTablet', price: 895 }
]

示例二：更新嵌入式文档

以下示例使用 updateMany() 更新价格大于 700 的产品中嵌入式文档 spec 的 ram、screen 以及 cpu 字段：

db.products.updateMany({
    price: { $gt: 700}
}, {
    $set: {
        "spec.ram": 32,
        "spec.screen": 9.8,
        "spec.cpu": 5.66
    }
})

返回结果显示成功更新 3 个文档：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 3,
  modifiedCount: 3,
  upsertedCount: 0
}

示例三：更新数组元素

以下示例使用 updateMany() 方法更新文档（_id 等于 1、2、3）中的数组字段 storage 的第一个元素和第二个元素：

db.products.updateMany({
    _id: {
        $in: [1, 2, 3]
    }
}, {
    $set: {
        "storage.0": 16,
        "storage.1": 32
    }
})

返回结果如下：

{
  acknowledged: true,
  insertedId: null,
  matchedCount: 3,
  modifiedCount: 3,
  upsertedCount: 0
}