BK-CI 数据库设计
适用场景
- 新增或调整表结构
- 编写 DDL、DML 或增量更新脚本
- 设计索引、唯一约束、查询路径
- 评估是否需要分表、归档或冷热分层
- 审查某个数据模型是否适合当前服务边界
不适用场景
- 只是写一条临时查询 SQL 排查数据
- 只是改业务代码，不涉及持久化模型和表结构
- 需求本质是 API 设计、模块归属或权限模型，不是数据库设计
快速指导
- 先确认数据归属到哪个服务。BK-CI 采用微服务拆分，禁止因为方便查询而跨服务共用数据库。
- 先决定表的角色，再决定字段和索引：
- 主实体表：存核心业务状态
- 关系表：表达多对多或映射关系
- 汇总表：承载聚合读模型
- 历史表：承载高频追加或归档数据
- 先按查询路径设计索引，不要先堆字段。最常用查询条件、排序字段、唯一约束字段优先进入索引设计。
- DDL 变更必须走脚本管理，不要直接在数据库里手工改线上结构。
- 变更前先考虑兼容性：
- 老字段是否仍被旧版本代码读取
- 新字段是否需要默认值
- 是否需要分阶段发布
- 大表问题优先判断是索引、归档、冷热分层还是分表，不要默认直接分片。
- 对 JSON、大文本、状态快照类字段，要明确为什么不能拆表，避免把主表做成“万能存储”。
高信号规则
- 脚本命名和版本目录要保持统一，详细规则见
reference/1-script-management.md - 分表与路由策略的细节见
reference/2-sharding.md - 表结构设计要服务于服务边界和查询模式，而不是追求理论上的“最全字段”
- 能用代码层聚合解决的问题，不优先通过跨服务数据库耦合解决
关键陷阱
- 只看写入模型，不看读路径，最后索引完全不匹配真实查询
- 先建“超大宽表”，后续再靠补丁式字段堆积解决一切问题
- 为了省事直接复用别的服务数据库，导致服务边界失效
- 把分表当成性能优化默认选项，忽略归档、汇总和冷热拆分
- 只改 DDL 不评估回滚、兼容和灰度发布路径
延伸阅读
- 脚本管理：
reference/1-script-management.md - 分表策略：
reference/2-sharding.md - 如果需求同时涉及模块归属，先看
00-bkci-global-architecture