投影统计与构建诊断
投影统计帮助评估数据规模、存储占用和使用情况；构建诊断帮助确认构建过程中使用的投影、数据源及执行计划。
前置条件与入口
当前用户需能查看目标投影及任务记录。在“数据整合 → 投影”打开投影详情的“概览”查看统计，在“更新记录 → 详情”查看构建诊断。首页“监控大盘”提供当前集群的“投影统计 Top 10”；看不到该模块时检查首页视角及模块配置。
统计指标
| 指标 | 含义与注意事项 |
|---|---|
| 行数 | 当前生效物化的行数；来源可为精确值、估算值或未知，不能统一当作实时精确计数 |
| 生效存储空间 | 当前生效物化对应的物理表占用 |
| 总占用 | 保留物化对应物理表的去重存储占用，包含过期但尚未删除的物化，不包含已删除物化 |
| 查询命中 | 查询使用该投影的累计次数 |
| 构建命中 | 其他构建任务使用该投影的累计次数 |
| 调用量 | 查询命中与构建命中的合计 |
同一物理表被多个物化记录引用时，不重复累计其空间。“暂无统计”或 - 表示当前未取得可用统计，不等于零行、零空间或从未使用。统计来自已收集的数据和任务记录，不应当作源表的实时行数，也不保证覆盖升级前全部历史。
详情页在可见时定期获取统计，当前间隔为 30 秒；这只是页面获取频率，不代表底层统计每 30 秒完成一次重算。统计更新失败时可使用“重试”。
查看集群排行
- 在首页打开“监控大盘”，找到“投影统计 Top 10”。
- 选择存储空间、行数或调用量，查看降序排列的前 10 个投影。
- 结合业务时效、构建成本和实际使用情况判断优化方向，不宜仅凭调用量低就删除投影。
排行在当前集群及访问权限范围内计算。存储排行使用生效存储空间；调用量不是监控大盘日期筛选范围内的查询次数。切换工作空间或集群后应重新核对范围。
解读构建诊断
- 打开目标投影的某次更新记录，进入“详情”及 SQL 优化信息。
- 先区分“考虑的投影”和“命中的投影”：候选被评估不代表最终采用。
- 核对“构建读取的数据源”及读取表，确认是否跨源，以及是否使用 AIR 物化存储。
- 检查优化后的执行计划、SQL 翻译和执行阶段耗时；下推写入还应检查源端计算、读取及清理阶段。
读取来源按物化改写后的计划统计，可能与原 SQL 直接引用的表不同。历史任务未记录相应信息时可能显示“暂无记录”，不能据此判断没有使用投影。
验证与排查
| 现象 | 检查方向 |
|---|---|
| 行数或空间为空 | 是否已有生效物化，统计是否完整，底层表是否可访问 |
| 总占用大于生效空间 | 是否保留旧物化、清理是否完成，以及多个物化是否共享物理表 |
| 候选多但命中少 | 投影状态、字段与过滤条件、权限及计算等价性 |
| 构建耗时较长 | 数据源读取范围、源端负载、并行度、源端计算和下推写入阶段 |