SQL 规划与统计信息¶
实现基线为 v4.2.5。SQL 文本、逻辑计划、物理 Scope/Pipeline 和实际运行统计分别描述不同阶段。
一条 SQL 的阶段¶
协议请求 → 解析 AST → 绑定库表/列/类型/权限上下文
→ QueryBuilder 与规则/统计 → 逻辑计划
→ Compile → Scope/Pipeline/算子 → 执行与结果编码
先从 Frontend 的请求分发和编译上下文读起,再看 pkg/sql/plan/build.go、query_builder.go,最后跟踪 pkg/sql/compile/compile.go、scope.go 与对应算子。Prepared statement、内部执行器及重试有自己的上下文/生命周期,不能仅按一次字符串解析理解。
统计信息与选择¶
统计用于估计行数、选择率、NDV、连接大小和扫描成本。DistTAE 的统计更新涉及 Logtail、对象元数据与后台计算;内存增量和持久化对象不是同一统计输入。新建/快速更新表、偏斜和采样会影响估计。
过滤下推、列裁剪、连接重排、索引选择、Runtime Filter、Shuffle 等必须结合实际计划分析。table_stats 有获取、刷新和测试用 patch 路径;patch 是诊断/测试入口,不作为生产数据修复方法。固定阈值和刷新周期应以源码/配置为准。
关键不变量:估计错误可以影响计划效率,但不能改变 SQL 结果;可选 Runtime Filter 的退化不能丢失合法行。
EXPLAIN 与执行¶
EXPLAIN 检查计划;EXPLAIN ANALYZE 实际执行,应确认语句副作用。比较扫描、过滤、连接方向、估计行数与实际数据,以及远端算子,而不只看计划是否包含一个索引名字。
慢 SQL 排查顺序:先核对结果和数据粒度,再检查扫描与过滤、统计估计、连接分布、内存/溢写、缓存与 I/O。计划变更需同时保留 SQL、DDL、数据规模、参数和构建。
提示与限制¶
表后的 USE INDEX、FORCE INDEX、IGNORE INDEX 由索引提示路径处理;Oracle 风格注释 /*+ INDEX(...) */ 或 ORDERED 不能仅凭语法接受宣称生效。未找到索引、冲突提示、覆盖不足或不适用计划都应记录实际结果,不能承诺每个提示强制生成任意计划。