NoSQL 与搜索 / 系统课时

使用唯一、部分与 TTL 索引

使用唯一、部分与 TTL 索引

这三类索引解决的是不同治理问题:unique 把唯一性下沉到数据库,partial 只维护业务上真正需要检索的文档子集,TTL 则让过期数据自动清理。正确组合它们,可以同时减少应用校验代码、索引体积和过期数据维护成本。

学习目标

  • 使用 unique 与 partialFilterExpression 表达业务约束
  • 判断查询何时能够安全使用 partial 索引
  • 用 TTL 索引实现自动过期,并理解它不是精确定时器

让唯一性成为数据库约束

唯一索引约束的是索引键,而不是应用代码里的“先查再写”。并发写入时,数据库会直接拒绝重复键,因此比应用层预检查可靠。字段允许缺失或 null 时,通常不应直接给整个字段建立普通唯一索引,而应把 unique 与 partial 组合,让约束只覆盖符合业务定义的文档。

下面用三个独立集合演示唯一、部分与 TTL 索引。示例故意只打印稳定结果,避免依赖版本相关的完整执行计划文本。

js
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)
}))

预期输出

text
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 自动清理到期数据 后台异步删除,不保证精确时刻

这三个属性不是互斥的“索引类型菜单”。设计时先写清楚业务约束:哪些值必须唯一、哪些文档值得进入索引、哪些数据允许自动删除,再决定是否组合属性。这样比先创建索引、再让业务去迁就索引语义更可靠。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用唯一、部分与 TTL 索引

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

登录哪都通