NoSQL 与搜索 / 系统课时

查询并原子更新数组字段

查询并原子更新数组字段

数组字段最容易出现两类错误:查询条件本想约束同一个元素,却意外匹配到不同元素;更新时为了改一个子项,先读取文档再写回。本篇用 $elemMatch、位置操作符和 arrayFilters 精确定位数组元素,并保持单文档更新的原子性。

学习目标

  • 用 $elemMatch 保证多个条件命中同一个数组元素。
  • 区分 $、$[] 与 $[identifier] 三类位置更新语义。
  • 使用 arrayFilters 一次原子修改满足条件的数组元素,避免客户端读改写。

先解决数组查询的“同一个元素”问题

假设订单的 items 是嵌入文档数组。若分别写 "items.sku": "mouse" 与 "items.qty": { $gte: 3 },MongoDB 允许两个条件由不同数组元素满足:一个元素的 sku 是 mouse,另一个元素的 qty 大于等于 3,整篇订单仍可能被匹配。

当业务语义要求“同一个数组元素同时满足这些条件”时,应把条件放进 $elemMatch。这不仅修正语义,对基于同一数组路径建立的 multikey 索引而言,也能让查询规划器更明确地组合相关边界。

用数组过滤器完成精确原子更新

下面的示例先查询“存在一个 OPEN 且数量至少为 2 的行项目”,再把所有 status = OPEN 且 qty < 3 的行项目数量加 1。整个 updateOne() 只修改一篇订单文档,但可以在该文档内部一次更新多个数组元素。

js
db.orders.drop();

db.orders.insertOne({
  _id: 1,
  orderNo: "O-1001",
  items: [
    { sku: "kbd", qty: 1, status: "OPEN" },
    { sku: "mouse", qty: 2, status: "OPEN" },
    { sku: "cable", qty: 3, status: "LOCKED" }
  ]
});

const matched = db.orders.findOne(
  {
    _id: 1,
    items: { $elemMatch: { status: "OPEN", qty: { $gte: 2 } } }
  },
  { _id: 0, orderNo: 1 }
);
print(EJSON.stringify(matched));

const result = db.orders.updateOne(
  { _id: 1 },
  { $inc: { "items.$[line].qty": 1 } },
  {
    arrayFilters: [
      { "line.status": "OPEN", "line.qty": { $lt: 3 } }
    ]
  }
);
print(EJSON.stringify({
  matchedCount: result.matchedCount,
  modifiedCount: result.modifiedCount
}));

const after = db.orders.findOne(
  { _id: 1 },
  { _id: 0, items: 1 }
);
print(EJSON.stringify(after));

预期输出:

text
{"orderNo":"O-1001"}
{"matchedCount":1,"modifiedCount":1}
{"items":[{"sku":"kbd","qty":2,"status":"OPEN"},{"sku":"mouse","qty":3,"status":"OPEN"},{"sku":"cable","qty":3,"status":"LOCKED"}]}

这里 modifiedCount 是 1,因为 MongoDB 统计的是被修改的文档数,不是数组元素数。两个 OPEN 元素都在同一次单文档原子更新中完成了 $inc。

选择正确的位置操作符

三种写法解决的问题不同。$ 表示查询条件定位到的第一个匹配数组元素,适合“改这一个已匹配元素”;$[] 表示数组中的所有元素,适合统一迁移或批量加同一字段;$[line] 表示所有满足对应 arrayFilters 的元素,适合一篇文档内的条件批量更新。

当目标条件稍复杂时,优先使用 $[identifier],因为匹配规则直接写在 arrayFilters 中,更新目标更清楚。标识符必须以小写字母开头并只包含字母和数字,例如 line、item2。同一个更新语句还可以定义多个标识符,分别约束不同层级的数组。

把原子性边界放在服务端更新语句里

MongoDB 对单文档写操作提供原子性保证。因此,若数组属于同一订单文档,应该尽量把“匹配哪些元素”和“如何修改”都编码进一个 updateOne(),而不是先 findOne() 到客户端、修改数组,再用整篇文档覆盖回去。后者在并发下更容易覆盖别人的更新,也传输更多数据。

原子性只覆盖这一篇文档,不会自动扩展到多篇文档。若一次业务操作必须同时修改多个订单并保持全有或全无,需要事务;若只是修改一个订单中的若干行项目,位置操作符通常已经是更轻量的正确选择。

还应把业务前置条件写进更新过滤器。例如只有订单处于 OPEN 才允许改数量,就把 status: "OPEN" 放进 updateOne() 的文档级过滤条件,而不是更新前单独查询一次。这样条件检查与写入处于同一个原子操作中,matchedCount: 0 也能明确表示状态已经不满足。

数组查询与更新的关键不是记住三个符号,而是先确定“条件是否必须命中同一元素”,再确定“要改第一个、全部还是满足过滤器的元素”。一旦这两个问题明确,$elemMatch 与位置操作符就能把原本容易出错的客户端读改写,收敛成一次可验证的服务端原子更新。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查询并原子更新数组字段

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通