doris-best-practices

用途：面向 Apache Doris 的表设计与集群规划实践指南，主打“先按问题定位方案”。适用于编写、审查或优化 CREATE TABLE 语句，以及处理分区/分桶、慢查询定位与容量估算等任务，包含 37 条规则、7 个用例模板与 4 份规格指南，细节存放在 references/ 目录。 主要能力：一是问题优先路由，按业务场景（实时日志/事件分析、CDC 同步、看板预聚合、点查 API、星型模型 JOIN、小维表、可观测性、车辆追踪、订单分析、全文检索、漏斗分析、半结构化 JSON）给出模板与关键规则；二是慢查询症状映射，如全表扫描、JOIN 慢、COUNT DISTINCT 慢、LIKE 慢、点查延迟高、存储增长快、数据倾斜、导入失败等，给出排查规则与快速修复方向；三是建表前检查清单与 DDL 硬约束（如 UNIQUE KEY 与 RANGE 分区列关系、键列需为前 N 列、store_row_column 适用范围、AUTO PARTITION 写法、异步 MV 刷新语法、BOOLEAN 默认值需加引号、BloomFilter 写法、AGGREGATE 语法顺序等）；四是提供 5 个 DDL 模板（追加型日志、带分区可更新表、小维表、预聚合 KPI、点查服务表）；五是连接与 CLI 用法，Doris 兼容 MySQL 协议，可用 mysql 客户端、SQL 与 FE HTTP REST API，若发行版提供可选 CLI 则优先使用 sql、tablet、profile get/list/diff/history、auth status、use 等命令，并建议结构化输出用 --format json；六是集群规划，含 FE、BE（一体存储与存算分离）、存储计算公式等指南。 限制：运行时慢查询诊断不应直接套用规则表，需先按 cli-investigation.md 收集或尝试证据；诊断映射为启发式，非最终结论；未提供具体发行版是否自带 CLI 的保证；缺失事实（如官方文本、具体版本差异细节）暂未提供。