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。