DataWorks提供HTTP觸發器節點,支援您通過調用OpenAPI的方式,從外部環境(如本地環境或跨租戶環境)觸發某一工作流程中的HTTP觸發器節點及其後續節點的執行。該功能可協助您實現本地任務觸發,或滿足跨租戶環境中的任務依賴執行需求。
產品介紹
HTTP觸發器節點是一種特殊的虛擬節點,允許你用DataWorks OpenAPI TriggerSchedulerTaskInstance觸發本節點及下遊節點的調度。
觸發器原理
當上遊任務節點運行完成,且外部調度系統發出調度指令後,HTTP觸發節點才會觸發下遊任務節點運行。觸發使用HTTP觸發器節點可參見觸發器節點使用示意圖。
觸發器節點使用示意圖
HTTP觸發器節點常用於外部環境與DataWorks調度系統的互連。
圖示說明:
在資料開發中,建立一個包含HTTP觸發器節點的工作流程,配置好各節點的依賴關係,並發布到營運中心。
系統會根據調度時間自動組建循環執行個體。您可以在這些執行個體中擷取HTTP觸發器節點的資訊(如節點ID、觸發時間)。
通過傳入這些資訊,使用Java、Python代碼或調試頁面調用OpenAPI介面來觸發節點運行。若只需觸發某個執行個體及其後續流程,
TriggerTime參數可設為固定值。若需動態觸發所有執行個體,則TriggerTime應設為動態變數。HTTP觸發器節點接收到並校正觸發命令後,將依次執行後續節點。
觸發條件
觸發HTTP觸發器節點需要滿足以下條件:
HTTP觸發器節點已經組建循環執行個體(在營運中心周期執行個體中可以找到該執行個體)。該執行個體在未被TriggerSchedulerTaskInstanceAPI成功觸發前,將處於等待觸發狀態,其下遊節點將被阻塞,直至成功調用
TriggerSchedulerTaskInstanceAPI觸發HTTP觸發器節點執行完成後,下遊節點依次執行。HTTP觸發器節點所依賴的所有父節點都已經執行成功(執行個體為成功狀態)。
HTTP觸發器節點產生的周期執行個體定時時間已到。
HTTP觸發器節點使用的調度資源群組,在觸發時間點資源充足。
HTTP觸發器節點處於非凍結狀態。
僅在等待觸發狀態下的HTTP觸發器節點才可被觸發(已成功觸發過的節點再次觸發將不會執行)。
注意事項
當上遊任務節點運行完成,且外部環境發出調度指令後,HTTP觸發節點才會觸發下遊任務節點運行。
如果外部環境提前發出調度指令,但是上遊任務節點沒有運行完成,HTTP觸發節點不會觸發下遊任務節點。系統會保留外部環境的調度指令,待上遊任務運行完成後,再通過HTTP觸發節點觸發下遊任務節點運行。
說明外部環境的觸發指令僅保留24小時。如果24小時內上遊任務節點沒有運行完成,則觸發指令會丟失,外部環境本次發出的調度指令失效。
當前HTTP觸發器節點執行個體被觸發執行成功後,不可再進行二次觸發。
前提條件
RAM帳號添加至對應空間(可選)。
進行任務開發的RAM帳號已被添加至對應工作空間中,並具有開發或空間管理員(許可權較大,謹慎添加)角色許可權。新增成員並授權,詳情請參見為工作空間增加空間成員。
對應空間已綁定Serverless資源群組。詳情請參見:使用Serverless資源群組。
進行HTTP觸發器節點開發前,需建立對應的HTTP觸發器節點,詳情請參見:建立周期任務。
使用限制
HTTP觸發器節點功能僅適用DataWorks企業版及以上版本,DataWorks版本詳情請參見DataWorks各版本詳解。
HTTP觸發器節點僅用於觸發任務,無法作為計算型任務使用。您需要將待啟動並執行任務節點設定為HTTP觸發器節點的下遊節點,以實現任務的觸發和執行。
建立HTTP觸發器節點
建立HTTP觸發器節點
建立入口參考:建立HTTP觸發器節點。
配置HTTP觸發器節點
建立HTTP觸發節點後,在HTTP觸發節點編輯頁面右側的調度配置中配置以下參數。更多參數配置,詳情請參見節點調度。
參數 | 說明 |
調度資源群組 | 選擇您所綁定的Serverless資源群組。 |
執行個體產生方式 | 可選擇T+1次日產生或發布後即時產生。 |
HTTP觸發器節點為空白節點,無需編寫節點內容。
HTTP觸發器節點上遊無節點時,預設上遊節點為商務程序的根節點。
發布HTTP觸發器節點
其他調度環境的觸發配置
外部調度環境中進行觸發配置時,您需要將擷取到的HTTP觸發節點執行個體參數配置到以下任一方式中,並通過調用TriggerSchedulerTaskInstance介面來觸發HTTP觸發器節點的執行。
擷取HTTP觸發節點執行個體參數
您可根據配置HTTP觸發器節點時選擇的執行個體產生方式,在營運中心查看並記錄HTTP執行個體參數資訊。
T+1次日產生:需要次日去營運中心查看並記錄HTTP執行個體參數資訊。
發布後即時產生:可立即前往營運中心查看並記錄HTTP執行個體參數資訊。
進入營運中心頁面。
登入DataWorks控制台,切換至目標地區後,單擊左側導覽列的,在下拉框中選擇對應工作空間後單擊進入營運中心。
在左側導覽列單擊,進入周期執行個體頁面。
在列表中找到您所建立的HTTP觸發器節點執行個體,記錄執行個體的任務ID和定時時間。
說明滑鼠懸浮到HTTP觸發器節點執行個體的名稱上方,即可查看執行個體的任務ID。
相關文檔
DataWorks提供HTTP觸發器節點功能,能夠在跨租戶的情境中實現任務的觸發與執行,詳情請參見HTTP觸發器節點實現跨租戶觸發節點執行。

