8. 来源执行(Source Run)与血统分析(Lineage)
8.1 什么是来源执行
当你的查询引用了其他标签页的快取结果时,这些上游标签页可能尚未执行或数据已过时。来源执行会自动:
- 分析你的 SQL,找出所有依赖的上游标签页。
- 按照正确的依赖顺序,逐一执行每个上游标签页。
- 最后执行你的目标标签页。
这确保你总是基于最新的数据进行查询。
8.2 执行来源执行并观看即时进度
- 打开一个 SQL 标签页(持久标签页或临时标签页;标签页内仅含一条 SQL 语句)。
- 点击工具列的 Source Run 按钮。
- 界面会弹出一个进度窗口,以流程图的形式呈现:
- 每个节点代表一个标签页或数据来源。
- 节点状态会即时更新(等待中 → 执行中 → 完成 / 错误)。
- 可查看每个节点的执行时间和错误讯息。
8.3 中止执行
在来源执行进行中,你可以随时点击 Abort 按钮中止执行。已完成的步骤不受影响,但当前正在执行的步骤会被取消。
8.4 查看血统图(Lineage Graph)
即使不执行来源执行,你也可以单独查看血统图来了解数据依赖关系:
- 在 SQL 标签页的工具列点击 Check Lineage 按钮(持久标签页与临时标签页皆可)。
- 或在 Data → Cached 的快取项目中选择「Check Lineage」。
血统图会以视觉化的方式呈现整个依赖链,你可以缩放和拖曳来浏览。
8.5 节点类型说明
血统图中的节点有以下类型:
| 节点类型 | 说明 |
|---|---|
| Physical | 实体数据文件(如 CSV、Excel 工作表等) |
| Cached | 其他标签页的快取结果 |
| Target | 你目前查看的目标标签页 |
| Unknown | 无法辨识的数据来源 |
注意: 来源执行与血统分析使用编辑器中的 SQL(含未存档变更)。持久标签页会物化快取;临时标签页可作末端重跑与查血缘,但不产生快取。标签页内只能包含单一 SQL 查询语句。
[图片] 血统分析图:展示多个节点的依赖关系
[图片] 来源执行进度窗口:节点状态即时更新
设计说明: Source Run DAG 与血缘设计见 统一查询层 §7.2–7.3。