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() 只修改一篇订单文档,但可以在该文档内部一次更新多个数组元素。
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));预期输出:
{"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 与位置操作符就能把原本容易出错的客户端读改写,收敛成一次可验证的服务端原子更新。