部分索引通过partialFilterExpression精准控制索引范围,仅索引满足条件的文档,可节省空间;需确保过滤后文档占比≤40%,避免在高基数字段使用,且不支持$ne、$or,修改须重建。

部分索引能真正减少存储空间,但前提是它只索引你实际需要的那部分文档——不是所有“可选字段”都适合用它,更不是加了就省空间。
部分索引比稀疏索引更精准控制索引范围
稀疏索引(sparse: true)只跳过“字段缺失或为 null”的文档,但无法表达“仅索引已验证邮箱的用户”这类业务逻辑;部分索引则通过 partialFilterExpression 明确限定条件,索引条目数直接由过滤结果决定。
- 支持的过滤操作符包括:
$exists: true、$eq、$gt、$type、$and、$in等,但不支持$ne或$or(除非嵌套在$and内) - 例如,只对已激活且邮箱非空的用户建索引:
db.users.createIndex({email: 1}, {partialFilterExpression: {status: "active", email: {$exists: true}}}) - 如果字段存在但值为空字符串
""或0,$exists: true仍会匹配——需结合$ne: ""进一步收紧
创建前必须确认字段实际分布,否则白建
部分索引节省空间的效果取决于 partialFilterExpression 能过滤掉多少文档。若条件太宽(比如 {deleted: false} 在软删比例仅 5% 的集合中),索引体积几乎不变,反而增加写入开销。
- 用聚合估算匹配比例:
db.users.aggregate([{$match: {status: "active", email: {$exists: true}}}, {$count: "matched"}])再除以总文档数 - 理想情况是过滤后保留文档占比 ≤ 40%,否则节省意义有限
- 避免在高基数字段(如
_id)上建部分索引——它本就不该占多少空间
复合部分索引要注意字段顺序和覆盖性
复合索引的前缀必须满足查询谓词,而 partialFilterExpression 是独立于排序/查询条件的额外筛选层。两者不等价,也不能互相替代。
- 以下索引能支撑查询
{category: "book", in_stock: true}并按price排序:db.products.createIndex({category: 1, in_stock: 1, price: 1}, {partialFilterExpression: {category: "book"}}) - 但无法支撑
{in_stock: true}查询——因为category不在查询条件中,前缀不匹配 - 如果查询常带
$text,不要把文本索引和部分索引混在同一定义里:文本索引不支持partialFilterExpression
删除或修改部分索引只能重建,不能原地更新
MongoDB 不提供修改现有索引的 partialFilterExpression 的接口。任何调整都必须先删后建,期间可能影响查询性能。
- 删除旧索引:
db.collection.dropIndex({field: 1})或用名称:db.collection.dropIndex("field_1_partial") - 建新索引前,建议先用
explain("executionStats")验证新过滤条件是否命中预期文档集 - 生产环境重建时,可用
background: true降低阻塞,但注意 background 索引在构建完成前不参与查询优化
最容易被忽略的是:部分索引一旦创建,MongoDB 会严格按 partialFilterExpression 执行索引构建,但查询时不会自动“补全”未被索引的文档——这意味着 countDocuments({}) 结果永远等于全量,而 countDocuments({yourField: {$exists: true}}) 才可能走索引加速,且仅当该条件完全匹配 partialFilterExpression 时才生效。











