# Apache Doris Query Profile证据交接清单 V0.1

状态：`static_contract`

## 用途

当Apache Doris查询变慢、数仓性能不达标或交付质量存在争议时，先形成一份可脱敏、可签收、不会直接触发生产改参的证据目录。

## 当前证据

- 清单依据Apache Doris官方Query Profile分析指南形成；
- 共20项、8列；
- 覆盖版本、采集时间、执行FE、Summary、ExecutionSummary、Fragment、Operator、BE差异、数据倾斜、资源、缺口和签收；
- 当前没有在具体Doris版本、生产或客户集群执行。

官方来源：

https://doris.apache.org/docs/dev/query-acceleration/query-profile/

## 四层读取顺序

| 层级 | 目的 | 公开安全表达 |
|---|---|---|
| Summary | 确认Profile、版本、时间窗和总耗时 | 哈希引用、版本、采集时间、耗时区间 |
| ExecutionSummary | 区分规划、调度和执行前阶段 | 阶段耗时和占比，不含SQL |
| MergedProfile | 找出主要Fragment和Operator | 类型、耗时占比、处理行数区间、倾斜比 |
| DetailProfile | 比较各BE与PipelineTask差异 | 原始内容留在受控位置，公开只给脱敏结论 |

## 五步使用方法

1. 确认Doris版本、采集权限、受控存储和业务时间窗；
2. 确认Profile来自执行该查询的FE；负载任务同时核对FE Master；
3. 按四层顺序提取阶段、Fragment、Operator和分布证据；
4. 将SQL、对象、节点、端点和完整Profile保留在受控位置；
5. 由平台、DBA和业务负责人签收后，再决定是否进入生产变更。

## 禁止事项

- 不公开客户SQL、库表、谓词、节点地址、账号或完整Profile；
- 不使用未经证实的性能阈值、收益或客户案例；
- 不因本清单自动开启全局Profile、修改FE/BE配置、改SQL、扩缩容或调整拓扑；
- Profile缺失时记录证据缺口，不得据此认定系统正常。

## 文件

- `doris-query-profile-evidence-checklist-v0.1.csv`
- `doris-query-profile-evidence-layers-v0.1.svg`
- `doris-query-profile-assets-v0.1.json`