NoSQL 与搜索 / 系统课时
设计 Multikey 数组索引
设计 Multikey 数组索引
数组字段一旦进入普通 B-tree 索引,MongoDB 会把一个文档展开成多个索引键。设计得当时,标签、权限集合和嵌套数组查询会明显受益;设计不当则容易撞上复合限制、数组匹配歧义和额外排序开销。
学习目标
- 理解数组字段如何自动形成 multikey 索引
- 设计合法的复合 multikey 索引并写出正确的数组查询
- 识别
$elemMatch与数组排序中的常见性能陷阱
从数组生成索引键
不需要显式声明“multikey”。只要索引路径在某个文档中取到数组,MongoDB 就会按数组元素生成索引键;同一文档里重复的数组值不会产生重复索引项。这样,查询 { tags: "ssd" } 可以直接定位包含该元素的文档,而不必扫描整份数组。

下面的 mongosh 示例同时演示标量数组和嵌套文档数组。第二个索引的两个键都来自同一个 offers 数组,因此可以合法形成复合 multikey 索引。
void db.catalog.drop()
void db.catalog.insertMany([
{
sku: "P1",
tenantId: "t1",
tags: ["ssd", "portable"],
price: 699,
offers: [{ shop: "A", price: 699 }, { shop: "B", price: 729 }]
},
{
sku: "P2",
tenantId: "t1",
tags: ["ssd", "desktop"],
price: 899,
offers: [{ shop: "A", price: 899 }, { shop: "B", price: 650 }]
}
])
print(db.catalog.createIndex(
{ tenantId: 1, tags: 1, price: 1 },
{ name: "tenant_tags_price" }
))
print(db.catalog.createIndex(
{ "offers.shop": 1, "offers.price": 1 },
{ name: "offer_shop_price" }
))
const ssd = db.catalog
.find({ tenantId: "t1", tags: "ssd" }, { _id: 0, sku: 1, price: 1 })
.sort({ price: 1 })
.toArray()
print("ssd=" + JSON.stringify(ssd))
const loose = db.catalog
.find({ "offers.shop": "A", "offers.price": { $lte: 700 } })
.toArray()
.map(x => x.sku)
print("loose=" + JSON.stringify(loose))
const sameElement = db.catalog
.find({ offers: { $elemMatch: { shop: "A", price: { $lte: 700 } } } })
.toArray()
.map(x => x.sku)
print("sameElement=" + JSON.stringify(sameElement))预期输出
tenant_tags_price
offer_shop_price
ssd=[{"sku":"P1","price":699},{"sku":"P2","price":899}]
loose=["P1","P2"]
sameElement=["P1"]守住复合索引限制
复合 multikey 索引的关键限制是:对任意被索引文档,复合索引中最多只能有一个独立索引字段取数组值。比如 { tags: 1, warehouses: 1 } 在同一文档里两个字段都是数组时不可用;已有索引后,后续写入让两个索引路径同时变成数组也会失败。
嵌套文档数组是另一种情况。offers.shop 与 offers.price 都来自同一个 offers 数组路径,可以建立复合索引,但查询必须明确“条件是否要求落在同一个数组元素上”。
用 elemMatch 绑定同一个数组元素
示例里的宽松查询返回 P2,因为 shop: "A" 来自第一个元素,而 price <= 700 来自第二个元素。MongoDB 只要求两个条件分别在数组中成立,并不自动要求它们来自同一对象。
当业务语义是“同一家店价格不超过 700”时,应使用 $elemMatch。它不仅修正匹配语义,也让同一数组路径上的多个条件更有机会形成更紧的索引边界。
把排序字段与数组职责分开
对 multikey 数组字段本身排序时,MongoDB 往往需要额外的内存排序阶段;只有满足特定索引边界条件时才可能直接利用索引顺序。生产设计中更稳妥的做法,是让数组字段承担包含关系过滤,让 price、createdAt、score 这类标量字段承担稳定排序。
如果查询经常同时按租户过滤、按标签筛选并按价格排序,可以像示例一样把稳定标量排序键放进复合索引,再用 explain("executionStats") 检查实际计划。最终是否保留某个 multikey 索引,应以真实查询形态、扫描键数量和写入成本共同决定。