索引别塞进 App 启动:DDL 归属心智模型

索引别塞进 App 启动:DDL 归属心智模型

Hello,我是小兔大白糖。 「启动时顺手建一下索引,本地多省事」——副本一多、账号权限一收、CI 空库一跑,这句话就会变成:每个实例抢建同一索引、启动变慢、测试偷偷改库结构、生产 DDL 没有独立变更单。

写成这篇,给要做数据库索引 / DDL 归属心智模型调研的初中级后端同学:文档库与关系库同理——应用进程 ≠ DDL 执行者。

说明:文中 EnsureIndexes / CreateIndex 等是教学名,泛指「应用启动或热路径里创建/确保索引」这类做法;模式 A/B/C 是分析框架,不是某厂 SLA。示例与伪流程均为教学脱敏示意。不写厂商内幕,也不写某仓库删启动建索引的工单流水。同站分工:Mongo 慢查询审计 管怎么量、怎么不说谎;本文钉谁有权改执行计划底座(索引)。分层变更纪律可对照:EKS 升级一次只动一层。

估计阅读时间:9 分钟


目录


为什么现在要关心

硬规则一句话:索引是 DDL(数据定义语言)合同,归迁移 / DBA / infra;应用只假设索引已存在,不在启动热路径里静默补洞。

删掉比喻之后,你仍应能对同事复述这五条:

  1. 索引是 DDL,不是业务热路径副作用:创建 / 改 / 删索引走迁移或运维通道,不塞进 main / 应用构造函数。
  2. 应用只读契约:查询按「索引已存在」来写;缺索引应暴露为可观测故障,而不是启动时偷偷建好。
  3. 多副本启动 ≠ 安全建索引窗口:并发 CreateIndex、锁等待、重复劳动、权限不足半成功,都很常见(具体锁语义因引擎与版本而异,按「常见故障模式」理解即可)。
  4. 测试也不该靠应用代码建「生产同款索引」碰巧变绿:需要唯一约束的用例,用夹具迁移,或改断言——别用 CreateIndex 作弊。
  5. Advisor / 自动建议是候选:落地仍走同一 DDL 通道,并做语义验证(证据怎么诚实,见慢查询审计文)。

心智模型:修路归市政

主比喻:路面是基础设施;出租车司机不在出车时铺沥青。

类比含义
修路归市政 / 路政DDL / 索引变更归属迁移、DBA 或 infra
司机只假设路面可用;坑洞报修,不自己浇柏油应用假设索引存在;缺了告警 / fail-fast,不启动自建
每个司机到岗都浇一遍柏油每个 Pod / 进程启动都跑一遍 EnsureIndexes

类比局限:修路故事解释谁执行 DDL、为何不在应用启动里做;解释不了该建哪条索引、查询形状怎么选——那是审计与选型另一篇的事。

DDL 归迁移 infra,应用只假设索引存在
DDL 归迁移 infra,应用只假设索引存在 · 点击查看 SVG 原图

精确定义:索引是 DDL 合同

把「索引变更」和「业务发版」拆开记账:前者改执行计划底座,后者改业务行为;混在同一启动副作用里,回滚面绑死。

概念人话边界
DDL改结构:表 / 集合形态、索引、约束通常要变更窗、权限、可回滚规划
DML改数据:增删改查应用日常热路径
EnsureIndexes 模式启动或初始化时 CreateIndex /「没有就建」单机开发省事;多实例与受限权限下成本高

文档型库与关系库在这一点上同构:CreateIndex / CREATE INDEX 都是结构变更,不是普通业务写入。应用账号若长期持有建索引权限,等于把生产 DDL 钥匙挂在每个副本腰上——各托管与自建的角色模型不同,文中「生产应用用户无 createIndex」是安全基线示意,落地以你们权限模型为准。


问题空间:本地绿、现场红

先分清「开发便利」和「多实例 + 权限收紧后的真实合同」。

你看到的常见真相
启动偶发超时 / 锁等待多实例并发建同一索引
本地绿;只读副本或受限角色红应用账号本就不该有 createIndex
测试依赖「先跑一遍 Ensure」空库语义与生产漂移;唯一约束测靠建索引作弊
索引变更无审计、难回滚DDL 埋进业务发布;出问题分不清是代码还是结构

和升级分层一样(见EKS 分层升级):一次搞清「谁改了结构」,比「日历上同一天一起发」更重要。


业界常见模式对照

调研默认选 B(迁移 / infra 显式 DDL);若要防漏迁,用 C 的 check-only——禁止 check 失败后自动 create。

模式做法优点代价
A. 启动 EnsureIndexesApp 启动 CreateIndex /「确保索引」单机开发省事多副本竞态;权限膨胀;DDL 无独立变更单
B. 迁移 / infra 显式 DDLmigrate 工具、IaC、DBA 变更窗可审、可规划回滚、与业务发版解耦本地要跑迁移;空环境要有文档
C. 混合:迁移为主 + 启动校验启动只检查关键则 fail-fast,不创建早发现漏迁仍要运维补洞流程;勿在 check 失败时自动建;索引很多时探测有超时成本,阈值按环境自测

模式 A 的隐藏税:每个新副本都可能付一遍「建索引」时间;CI 空库一跑,测试变成隐性迁移器;生产一收权,半成功比全失败更难查。

三种模式:启动建、显式迁移、只校验
三种模式:启动建、显式迁移、只校验 · 点击查看 SVG 原图

可复述清单与伪流程

目标态:索引定义有单一事实源;应用启动不建索引;新索引先证据、再变更窗、再依赖查询。

  1. 清点所有 CreateIndex / Ensure* 入口(启动、脚本、测试 helper)。
  2. 索引定义迁到迁移目录或 infra 清单;PR 可与业务代码分轨审。
  3. 应用启动去掉建索引;可选存在性探测 + 明确错误(模式 C)。
  4. CI:迁移 up 后再跑集成测;禁止测试里 CreateIndex「铺路」。
  5. 运行账号权限:生产应用用户无 createIndex(示意;以你们安全基线为准)。
  6. 观测:启动耗时、索引构建锁 / 等待、权限错误率。
  7. 新索引:先审计证据 → 变更单 → 窗内建 → 再让查询依赖它。

伪流程(教学示意,非某框架 API):

boot(app):
  # NOT create_indexes()
  optionally assert_required_indexes_exist()  # fail-fast or warn
  start_serving()

change_index(spec):
  review → migrate / infra apply in change window
  app assumes new index only after apply succeeds

反模式

下面五条,删掉场景名之后仍应能当评审红线念。

  1. 每个服务自己 Ensure 一套「完整索引」——多服务抢同一库时,竞态与权限面翻倍。
  2. 测试 CreateIndex 冒充生产就绪——绿的是「测试账号会建索引」,不是「迁移已覆盖」。
  3. 只读分析账号被授予建索引「图方便」——分析面变成第二条 DDL 通道。
  4. 把 Advisor 建议直接写进启动代码——未验证候选变成每个 Pod 的副作用。
  5. 索引与业务逻辑同一 commit,且无独立回滚说明——结构与行为绑死,出事只能整包回滚。

选型结论

  • DDL 归迁移 / infra;App 不建索引。
  • 要防漏迁:用存在性检查(模式 C),不要用启动自动 create(模式 A)。
  • 与慢查询审计分工:那边诚实量形状与请求合计;本文钉谁有权改索引。
  • 可带走的复述句:修路归市政;司机报坑,不浇柏油。