本文可協助您瞭解 Dataform 中的工作區概念及其功能。
在 Dataform 中，您可以在開發工作區中與 SQL 工作流程程式碼互動。開發工作區是您可編輯的存放區副本。您可以在工作區中建立、編輯或刪除存放區的內容，不會影響在該存放區作業的其他使用者，然後提交並將變更推送至存放區。
您可以使用 Dataform 核心或 JavaScript 開發 SQL 工作流程。Dataform 會即時將程式碼編譯為 SQL 查詢。
您可以在開發工作區中執行下列工作：
- 調整 Dataform 設定。
- 建立資料表 (所有支援類型)。
- 文件資料表。
- 分割表格。
- 在資料表中加入 BigQuery 標籤和政策標記。
- 覆寫表格設定。
- 設定其他動作。
- 為 SQL 工作流程宣告資料來源。
- 在 SQL 工作流程中新增自訂 SQL 作業和標記。
- 觸發 SQL 工作流程或所選動作的執行作業。
- 監控執行記錄檔。
開發工作區的元件
Dataform 開發工作區包含下列分頁：
- 程式碼
- 包含開發環境，可讓您探索檔案、開發查詢、控管變更版本，並觸發 BigQuery 執行作業。
- 已編譯的圖形
- 以互動式有向非循環圖 (DAG) 的形式，顯示在工作區中定義的已編譯 SQL 工作流程。如果 SQL 工作流程中有編譯錯誤，分頁會顯示錯誤訊息，而非圖表。
- 執行作業
- 顯示工作區中所有觸發執行作業的記錄。您也可以查看所選執行作業的動作和詳細資料。詳情請參閱「監控執行記錄」。
「Code」分頁的元件
開發工作區的「Code」分頁包含下列元件，可讓您開發 SQL 工作流程：
- 「檔案」窗格
- 顯示工作區的檔案結構。自動將編輯內容儲存至檔案結構。所選檔案會在開發窗格中的分頁中開啟。在「輸入要搜尋的內容」欄位中，您可以依路徑搜尋工作區中的檔案或目錄。
- 版本管控窗格
- 顯示工作區的版本控制狀態和版本控制選項。
- 「Development」窗格
- 在分頁中顯示已開啟的檔案。自動儲存編輯檔案的變更內容。
- 「Run」按鈕
- 執行已編譯 SQL 查詢的預覽畫面。
- 格式按鈕
- 設定 Dataform 核心或 JavaScript 程式碼的格式。
- 編譯狀態
- 顯示工作區中程式的編譯狀態。
- 中繼資料窗格
- 顯示已編輯檔案的中繼資料。
- 「已編譯的查詢」窗格
- 將編輯檔案中的查詢編譯為 SQL。如果查詢編譯作業失敗，系統會顯示編譯錯誤。如果查詢編譯作業成功，系統會顯示已編譯的查詢，並透過 BigQuery 的模擬執行作業驗證這些查詢。如果查詢驗證失敗，系統會顯示驗證錯誤。如果查詢驗證成功，系統會顯示執行 BigQuery 查詢所需的位元組數。
- 「Start execution」下拉式選單
- 顯示可觸發工作區或所選元素中整個工作流程執行作業的選項。
「已編譯」圖表分頁的元件
「已編譯」圖形分頁會顯示已編譯 SQL 工作流程的互動式圖形。這張圖表會顯示 SQL 工作流程中的所有動作，以及這些動作之間的關係。
您可以放大/縮小圖表，並使用拖曳方式瀏覽圖表。
您可以依據下列屬性篩選圖表：
- 名稱
- 標記
- 類型
- 斷言
- 宣告
- 累加資料表
- 具體化檢視表
- 作業
- 資料表
- 不明
- 查看
您可以一次選取多個篩選器。Dataform 會套用 OR 條件。
您可以按一下圖表中的動作，在下列窗格中查看詳細資料：
- 中繼資料窗格
- 顯示所選動作的完整名稱、類型、依附元件和依附元件。
- 「查詢」窗格
- 顯示所選動作的已編譯 SQL 查詢。
工作區中的版本控制
在工作區中，您可以透過以 Git 為基礎的版本控制功能與存放區互動。您對工作區檔案所做的編輯會先以未提交的本機變更形式存在，您可以提交這些變更，然後推送至存放區，讓所有存放區使用者都能存取。
如果存放區已連線至遠端 Git 供應商，您可以將工作區中的變更推送至主要開發分支版本。將存放區連結至遠端 Git 供應工具時，您會選取主要分支。在未連結的 Dataform 存放區中，您會將變更推送至預設分支。
您也可以從 Dataform 存放區或遠端存放區提取任何變更，並在開發工作區中將其與本機變更合併。如要進一步瞭解 Dataform 中的版本管控，請參閱「程式碼版本管控」。
後續步驟
- 如要瞭解如何建立及初始化工作區，請參閱「建立工作區」。
- 如要瞭解如何對 Dataform 程式碼進行版本管控，請參閱「對程式碼進行版本管控」。
- 如要瞭解如何執行預覽功能來測試 SQL 查詢，請參閱「預覽 SQL 查詢」。