組件是一種帶有多個輸入參數和輸出參數的SQL代碼過程模板,而SQL代碼過程可通過引入一個或多個來源資料表,並進行過濾、串連、彙總等操作,加工出業務所需的目標表,因此,您可通過組件快速加工出符合業務需求的目標表。本文為您介紹組件的相關內容以及定義與使用。
SQL組件概述
組件介紹
在實際業務實踐中,存在大量類似的SQL代碼過程,過程中輸入表和輸出表的結構一致或結構類型相容,僅名稱不同。此時,組件的開發人員可將該SQL過程抽象為一個SQL元件節點,將可變的輸入表抽象為輸入參數,可變的輸出表抽象為輸出參數,實現SQL代碼的複用。
後續在使用SQL元件節點時,只需從程式碼群組件列表中選擇和自己的業務處理過程類似的組件,並為該組件配置自己業務中特定的輸入表和輸出表,無需再次編輯代碼,便可直接產生新的SQL元件節點,極大提升了開發效率,避免重複開發。SQL元件節點產生後的發布、調度操作,與普通SQL節點的操作方式相同。
許可權說明
您需具備DataWorks工作空間的開發許可權,才可建立並使用組件。授權詳情請參見增加空間成員並管理成員角色許可權。
使用限制
僅DataWorks標準版及以上版本,才可使用SQL元件節點功能。詳情請參見DataWorks各版本詳解。
本工作空間成員建立的組件在組件下。
租戶成員建立的組件在公用組件下。
組件類型
組件分為專案組件及公用組件,組件開發人員(即建立組件的使用者)在建立組件時可自行定義。
專案組件:組件發布後,預設僅該DataWorks工作空間的使用者均可使用。若您希望使用該類組件,則需成為此工作空間的成員,詳情請參見增加空間成員並管理成員角色許可權。
公用組件:組件的開發人員可進入公開組件頁簽,將具有全域通用性的組件發布到整個租戶內,發布後,租戶內所有使用者均可使用該公用組件。
組件使用流程
在DataWorks中建立的組件需與DataWorks的SQL元件節點配合使用,具體流程如下:
定義SQL組件
進入組件管理頁面
進入資料開發頁面。
登入DataWorks控制台,切換至目標地區後,單擊左側導覽列的,在下拉框中選擇對應工作空間後單擊進入資料開發。
在左側導覽列單擊組件管理,進入組件管理頁面。
說明若左側導覽列不存在組件管理,則可單擊左下角的
表徵圖,根據模組管理自行添加。
建立並配置組件
以下為您介紹組件開發人員如何通過組件管理新群組件,將指定的SQL過程抽象為一個SQL模板。一個組件通常由過程體、輸入參數、輸出參數組成。過程體用於定義組件功能的實現代碼,在過程體中,通過@@{變數名}格式,將可變的輸入表或輸入字串抽象為組件的輸入參數,將可變的輸出表抽象為組件的輸出參數,實現SQL代碼的複用。
一個組件可配置多個輸入參數和輸出參數,具體請根據實際使用進行配置。

步驟一:建立組件
組件管理頁面,您可通過如下方式建立組件並輸入組件名稱。
本工作空間成員建立的組件在組件下。
租戶成員建立的組件在公用組件下。
步驟二:配置組件資訊
步驟三:儲存並提交組件
單擊
表徵圖,儲存組件;單擊
表徵圖,提交組件。組件建立完成後,可在SQL元件節點中引用,協助您快速產生業務所需的目標表。使用詳情請參見引用SQL組件。
引用SQL組件
前提條件
已準備所需使用的組件,詳情請參見定義SQL組件。
已建立SQL元件節點,詳情請參見建立並管理MaxCompute節點。
引用組件
您需在已建立的SQL元件節點的編輯頁面引用組件:
選擇所需引用的組件。
如果沒有可用組件,請參考定義SQL組件建立。
若所選組件存在最新版本,您可根據業務需要選擇是否更新代碼版本,引用最新組件版本。
單擊開啟組件即可查看組件詳情。
根據實際使用配置組件參數值。
後續步驟
當您完成當前節點的任務開發後,通常您可進行以下操作。
調度配置:配置節點的周期性調度屬性。任務需要周期性調度運行時,您需要設定節點後續實際運行過程中的重跑屬性、調度依賴關係等,操作詳情請參見任務調度屬性配置概述。
任務調試:對當前節點的代碼進行測試回合,確認代碼邏輯符合預期,操作詳情請參見任務調試流程。
任務發布:完成所有開發相關操作後,您需要將所有任務節點進行發布,發布後節點將根據調度配置結果進行周期性運行,操作詳情請參見發布任務。
管理組件
分享及查看組件的引用記錄
升級組件
更多參考
使用組件介面功能介紹
最佳實務
前提條件
已建立SQL元件節點,詳情請參見建立並管理MaxCompute節點。
已在ODPS SQL節點中建立好輸入表和輸出表。





參數值說明如下: