Mongodb使用$＜identifier＞过滤更新数组元素的示例代码实用指南

作者：袖梨 2026-09-04

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Mongodb采用$＜identifier＞过滤更新数组元素的示例代码”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

目录
  • 定义
  • 行为
  • 应用
    • 更新符合arrayFilters条件的数组元素
    • 更新数组中符合arrayFilter条件的文档
    • 更新符合多个查询条件的数组元素
    • 采用反向操作符查询更新数组中的文档元素
    • 与$[]集合采用更新数组内嵌套数组元素值

定义

结合项目来看，带有过滤器的位置操作符$<identifier>定义数组中数据更新时，只符合identifier定义条件的元素才能够更新。其中<identifier>作为查询条件，需在arrayFilters中定义。语法如下所示

{<update operator>: { "<array>.$<identifier>": value}},
{ arrayFilters: [{<identifier>: <condition>}]}

搭配采用arrayFiters，更新数组元素中符合过滤条件的数组。

db.collection.updateMany(
  { <query conditions>},
  { <update operator>: { "<array>.$[<identifier>]": value}},
  { arrayFilters: [{<identifier>: <condition>}]}
)

落到代码里，其中identifier,是一小写字母开头的字符串，只能包含小写字母和数字

行为

  • 落到代码里，自mongodb5.0开始，UPDATE操作按照字段名称的字典顺序更新字段。当字段中包含数字时，按照数字顺序依次更新字段。当然，对一个文档的多个字段操作，是原子性的。
  • 落到代码里，在arrayFilters里，不能包含文本索引操作符$expr, $text, $where
  • 理解这一步时，采用{upsert: true}同时产生insert行为时，数据查询过滤条件必须包含一个针对操作数组字段的精确查询。这样才能够在update语句中，采用$[identifier]操作符。按照下面的更新语句，来定义查询和采用$[identifier]操作符。
db.collection.update(
  {myArray: [5,8]},//查询过滤条件中必须包含myArray数组
  {$set:  {"myArray.$[element]": 10}},//更新字段名称为myArray的数组中所有元素
  {upsert: true, arrayFilters: [{element: 0}]}
)

没有文档符合查询条件时，该操作向数据库中插入一份新的文档。

{ "_id": ObjectId(...), "myArray": [10, 10]}

落到代码里，数据更新操作中没有包含该数组的精确查询时，若数据集中不包含符合查询条件的数据记录，更新插入操作会报错。下面的两个数据更新操作会报错。

db.emptyCollection.updateOne(
  {},
  { $set: {"myArray.$[element]": 10}},
  { upsert: true, arrayFilters: [{element: 9}]}
)
 
WriteError({
    "index" : 0,
    "code" : 2,
    "errmsg" : "The path 'myArray' must exist in the document in order to apply array updates.",
    "op" : {
        "q" : {
            
        },
        "u" : {
            "$set" : {
                "myArray.$[]" : 10
            }
        },
        "multi" : false,
        "upsert" : true
    }
})
  • $[]操作符能够用在多层嵌套数组当中。

应用

更新符合arrayFilters条件的数组元素

向students表插入数据。其中grades字段是数字类型的数组。

db.students.insertMany([
    { "_id" : 1, "grades" : [ 95, 92, 90 ] },
    { "_id" : 2, "grades" : [ 98, 100, 102 ] },
    { "_id" : 3, "grades" : [ 95, 110, 100 ] }
])

构建数据更新语句，将大于100分的数据更新为100.

db.students.updateMany(
    {},
    { $set:  {"grades.$[element]": 100}},
    { arrayFilters: [{"element": {$gte: 100}}]}
)

更新数组中符合arrayFilter条件的文档

实际处理时，采用$[identifier]操作符，能够更新数组内包含的文档字段值。$[identifier]操作符与点操作符一起，指定数组内文档元素字段名称，实现字段值的更改。

db.collection.updateOne(
  {<query selector>},
  { <update operator>: {"array.$[identifier].field"：value}}
  { arrayFilters: [{<identifier>: <condition>}]}
)

构建students2 集合，其中grades是文档型数组。

db.students2.insertMany([
    {
      "_id" : 1,
      "grades" : [
         { "grade" : 80, "mean" : 75, "std" : 6 },
         { "grade" : 85, "mean" : 90, "std" : 4 },
         { "grade" : 85, "mean" : 85, "std" : 6 }
      ]
   },
   {
      "_id" : 2,
      "grades" : [
         { "grade" : 90, "mean" : 75, "std" : 6 },
         { "grade" : 87, "mean" : 90, "std" : 3 },
         { "grade" : 85, "mean" : 85, "std" : 4 }
      ]
   }])

更新符合多个查询条件的数组元素

向students3集合插入数据

db.students3.insertMany([
    {
      "_id" : 1,
      "grades" : [
         { "grade" : 80, "mean" : 75, "std" : 6 },
         { "grade" : 85, "mean" : 100, "std" : 4 },
         { "grade" : 85, "mean" : 100, "std" : 6 }
      ]
   },
   {
      "_id" : 2,
      "grades" : [
         { "grade" : 90, "mean" : 100, "std" : 6 },
         { "grade" : 87, "mean" : 100, "std" : 3 },
         { "grade" : 85, "mean" : 100, "std" : 4 }
      ]
   }
    ])

结合项目来看，构建数据更新语句，要求将grades数组中，grade大于等于30同时std大于等于5的元素std值减少1

db.students3.updateMany(
    {},
    {$inc: {"grades.$[elem].std": -1}},
    {arrayFilters: [{"elem.grade": {$gte: 80}, "elem.std": {$gte: 5}}]}
    )

采用反向操作符查询更新数组中的文档元素

向集合alumni插入数据

db.alumni.insertMany([{
      "_id": 1,
      "name": "Christine Franklin",
      "degrees": [
         { "level": "Master" },
         { "level": "Bachelor" }
      ],
  },
   {
      "_id": 2,
      "name": "Reyansh Sengupta",
      "degrees": [ { "level": "Bachelor" } ],
   }
    ])

理解这一步时，构建数据更新语句，要求将degrees数组中level=Bachelor以外的元素，添加字段gradcampaign,同时将字段值设置为1.

db.alumni.updateMany(
    {},
    {$set: {"degrees.$[degree].gradcampaign": 1}},
    { arrayFilters: [ {"degree.level": {$ne: "Bachelor"}}]}
    )

与$[]集合采用更新数组内嵌套数组元素值

结合项目来看，向集合students4插入数据。其中grades是文档数组。文档的questions字段是数字数组类型。

db.students4.insertOne(
   { "_id" : 1,
      "grades" : [
        { type: "quiz", questions: [ 10, 8, 5 ] },
        { type: "quiz", questions: [ 8, 9, 6 ] },
        { type: "hw", questions: [ 5, 4, 3 ] },
        { type: "exam", questions: [ 25, 10, 23, 0 ] },
      ]
   }
)

落到代码里，构建数据更新语句，要求更新grades数组中，type字段值为quiz的文档，将questions数组中大于等于8的元素值增加2.

db.students4.updateMany(
    {},
    { $inc: {"grades.$[t].questions.$[score]": 2}},
    {arrayFilters: [{"t.type": "quiz"}, {"score": {$gte: 8}}]}
    )

理解这一步时，其中，$[t]和$[score]中括号当中，不需添加空格，否则mongodb会报错。

WriteError({
    "index" : 0,
    "code" : 2,
    "errmsg" : "No array filter found for identifier ' t ' in path 'grades.$[ t ].questions.$[score]'",
    "op" : {
        "q" : {
            
        },
        "u" : {
            "$inc" : {
                "grades.$[ t ].questions.$[score]" : 2
            }
        },
        "multi" : true,
        "upsert" : false,
        "arrayFilters" : [
            {
                "t.type" : "quiz"
            },
            {
                "score" : {
                    "$gte" : 8
                }
            }
        ]
    }
})

理解这一步时，构建数据更新语句，要求更新grades数组中的所有文档，将questions数组中大于等于8的元素值增加2.

{
  "acknowledged": true,
  "matchedCount": 1,
  "modifiedCount": 1
}

实际处理时，以上就是Mongodb采用$＜identifier＞过滤更新数组元素的示例的详细内容，更多关于Mongodb $＜identifier＞过滤元素的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
  • Mongodb过滤器filter选择要得到的数组子集操作方法
  • mongodb中根据时间过滤进行查询的操作方法
  • mongodb如何对文档内数组进行过滤的方法步骤

相关文章

精彩推荐