NoSQL 与搜索 / 系统课时
使用唯一、部分与 TTL 索引
使用唯一、部分与 TTL 索引
这三类索引解决的是不同治理问题:unique 把唯一性下沉到数据库,partial 只维护业务上真正需要检索的文档子集,TTL 则让过期数据自动清理。正确组合它们,可以同时减少应用校验代码、索引体积和过期数据维护成本。
学习目标
- 使用 unique 与
partialFilterExpression表达业务约束 - 判断查询何时能够安全使用 partial 索引
- 用 TTL 索引实现自动过期,并理解它不是精确定时器
让唯一性成为数据库约束
唯一索引约束的是索引键,而不是应用代码里的“先查再写”。并发写入时,数据库会直接拒绝重复键,因此比应用层预检查可靠。字段允许缺失或 null 时,通常不应直接给整个字段建立普通唯一索引,而应把 unique 与 partial 组合,让约束只覆盖符合业务定义的文档。
下面用三个独立集合演示唯一、部分与 TTL 索引。示例故意只打印稳定结果,避免依赖版本相关的完整执行计划文本。
void db.users.drop()
void db.jobs.drop()
void db.sessions.drop()
void db.users.insertMany([
{ _id: 1, email: "a@example.com" },
{ _id: 2 }
])
print(db.users.createIndex(
{ email: 1 },
{
name: "uniq_email_when_present",
unique: true,
partialFilterExpression: { email: { $type: "string" } }
}
))
try {
db.users.insertOne({ _id: 3, email: "a@example.com" })
} catch (e) {
print("duplicateErrorCode=" + e.code)
}
void db.users.insertMany([
{ _id: 4, email: null },
{ _id: 5, email: null }
])
print("users=" + db.users.countDocuments())
void db.jobs.insertMany([
{ jobId: "J1", tenantId: "t1", status: "PENDING", nextRunAt: ISODate("2030-01-01T10:00:00Z") },
{ jobId: "J2", tenantId: "t1", status: "DONE", nextRunAt: ISODate("2030-01-01T09:00:00Z") }
])
print(db.jobs.createIndex(
{ tenantId: 1, nextRunAt: 1 },
{
name: "pending_by_tenant_time",
partialFilterExpression: { status: "PENDING" }
}
))
const pending = db.jobs
.find({ tenantId: "t1", status: "PENDING" })
.sort({ nextRunAt: 1 })
.toArray()
.map(x => x.jobId)
print("pending=" + JSON.stringify(pending))
void db.sessions.insertOne({
sessionId: "S1",
expiresAt: ISODate("2030-01-01T00:00:00Z")
})
print(db.sessions.createIndex(
{ expiresAt: 1 },
{ name: "expire_at", expireAfterSeconds: 0 }
))
const ttl = db.sessions.getIndexes().find(i => i.name === "expire_at")
print(JSON.stringify({
name: ttl.name,
expireAfterSeconds: Number(ttl.expireAfterSeconds)
}))预期输出
uniq_email_when_present
duplicateErrorCode=11000
users=4
pending_by_tenant_time
pending=["J1"]
expire_at
{"name":"expire_at","expireAfterSeconds":0}用 partial 只索引业务子集
partialFilterExpression 决定哪些文档进入索引。它适合“待处理任务”“有效订单”“已发布内容”这类只查询小部分状态的业务集,既减少索引空间,也降低无关写入带来的维护成本。
查询优化器只有在查询条件能够保证结果完全落在 partial 过滤范围内时,才会安全使用该索引。示例索引只包含 status: "PENDING" 的任务,因此带有这个条件的查询适合使用它;省略状态条件的全量任务查询不能依赖该索引得到完整结果。
unique 与 partial 可以组合。示例中只有字符串类型的 email 进入唯一索引,所以缺失值和 null 不受唯一约束,而两个相同的字符串邮箱会触发重复键错误。创建唯一索引前仍要先清理已有重复数据,否则索引构建本身会失败。
用 TTL 管理可自动丢弃的数据
TTL 索引适合会自然失效的数据,例如会话、验证码、临时任务和短期日志。TTL 是单字段索引,索引字段应保存日期值。将 expireAfterSeconds 设为 0 时,可以把字段本身当作绝对过期时间:文档到达 expiresAt 后进入可删除状态。
TTL 删除由后台机制异步执行,因此“已经到期”不等于“这一毫秒已经物理删除”。如果业务要求某个时间点之后绝对不可再读,应在查询或授权逻辑中同时判断过期时间,而不是把 TTL 当作精确定时器。
按约束、子集和生命周期选型
| 索引属性 | 最适合解决的问题 | 关键边界 |
|---|---|---|
| unique | 跨并发写入保证键唯一 | 已有重复数据会阻止创建 |
| partial | 只索引满足条件的文档 | 查询条件必须能证明结果落在过滤范围 |
| TTL | 自动清理到期数据 | 后台异步删除,不保证精确时刻 |
这三个属性不是互斥的“索引类型菜单”。设计时先写清楚业务约束:哪些值必须唯一、哪些文档值得进入索引、哪些数据允许自动删除,再决定是否组合属性。这样比先创建索引、再让业务去迁就索引语义更可靠。