BK-CI 数据库设计技能用于在 BK-CI 项目中设计数据库表、DDL 脚本、索引、分表或数据归档策略。
适用场景
新增或调整表结构；编写 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。