《MongoDB入门教程》第14篇 CRUD之更新文档
Posted 不剪发的Tony老师
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了《MongoDB入门教程》第14篇 CRUD之更新文档相关的知识,希望对你有一定的参考价值。
本篇我们将会介绍如何使用集合的 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
以上是关于《MongoDB入门教程》第14篇 CRUD之更新文档的主要内容,如果未能解决你的问题,请参考以下文章