DataWorks：配置同周期調度依賴

節點輸出

節點輸出即本節點輸出名稱，是其他節點與本節點建立依賴關係的媒介（標識符），而不是節點實際產出的資料。其他節點通過本節點的輸出名稱找到本節點，從而將本節點設定為上遊依賴。

DataWorks會為每個節點自動產生兩個輸出名：

• projectName.randomNumber_out：全域唯一，且不支援修改和刪除。

• projectName.nodeName：帶節點名的輸出，修改。節點名稱變更後，此輸出名不變。

同時，DataWorks也支援通過手動添加或者從代碼解析輸入輸出，其中不同的節點類型對代碼解析的支援情況可參考：代碼解析結果對比。

節點輸入

節點輸入即本節點依賴的上遊節點，可通過指定節點的輸出名稱（推薦）、節點名稱或者節點ID指定。

其中節點ID需要上遊節點提交至生產環境才會產生。

通過代碼解析表血緣設定節點依賴

代碼解析是通過解析節點代碼中的表血緣，自動化佈建節點的輸出名稱和依賴的上遊節點。解析後，節點產出的表將被自動添加為projectname.tablename格式的節點輸出；節點查詢的表將被自動添加為節點輸入。

例如，SELECT一張表，該表將被自動解析為本節點依賴的上遊；INSERT一張表，該表將被自動解析為本節點的輸出。各類型節點自動解析支援的關鍵字，詳情請參見各類型節點自動解析情境。

• 配置依賴

  代碼解析支援手動從代碼中解析輸入輸出和提交前自動解析兩種方式。兩者原理一致，提交前自動解析會在代碼提交時自動解析輸入輸出，並提醒您掛載依賴。

  例如：ODPS節點mc2需依賴節點mc1的輸出表dws_user_info_all_di，節點mc2的代碼內容如下：

  INSERT OVERWRITE TABLE ads_user_info_1d PARTITION (dt='${workflow.var}')
  SELECT uid
    , MAX(region)
    , MAX(device)
    , COUNT(0) AS pv
    , MAX(gender)
    , MAX(age_range)
    , MAX(zodiac)
  FROM dws_user_info_all_di
  WHERE dt = '${workflow.var}'
  GROUP BY uid;

  單擊從代碼中解析輸入輸出後，解析出本節點的輸入為dws_user_info_all_di表，並且自動匹配到上遊節點的輸出表名和上遊節點名稱：

  上遊節點輸出名	上遊節點輸出表名	上遊節點名稱	節點ID	工作空間	責任人	調度周期	添加方式	最近運行情況	操作
  yunwan_lingyi.dws_user_info_all_di	yunwan_lingyi.dws_user_info_all_di	mc1	-	測試空間	lingyi01_testcloud_com	日	代碼解析	暫無資料	刪除

  同時，解析出本節點的輸出為ads_user_info_1d表，對應解析情況如下：

  輸出名	輸出表名	下遊節點名稱	責任人	添加方式	下遊節點影響基準	操作
  old_ide.505487297_out	-	-	-	系統預設添加	-	刪除
  old_ide.mc2	-	-	-	手動添加	-	刪除
  yunwan_lingyi.ads_user_info_1d	yunwan_lingyi.ads_user_info_1d	-	-	代碼解析	-	刪除

  至此，節點mc2完成與節點mc1的依賴配置。

• 修改代碼解析的依賴關係

  當代碼解析的依賴關係不符合預期，或存在不支援調度依賴的情境（非周期性調度產出資料的表）需手動刪除依賴關係時，您可參考以下內容修改自動解析的依賴關係。

  操作	描述
  手動刪除解析結果	在依賴的上遊節點列表中中刪除不符合預期的輸入，執行刪除操作，並重新解析。刪除後，自動添加相應注釋至代碼中，防止下次解析再次添加： --@exclude_input=刪除輸入 --@exclude_output=刪除輸出
  手動添加輸入輸出	在代碼編輯框中右擊表名，選擇添加輸入或者添加輸出，添加後，自動添加相應注釋至代碼中 --@extra_output=添加輸出 --@extra_input=添加輸入 或者也可以參考通過調度配置介面手動添加上遊節點依賴或者通過商務程序面板拉線設定節點依賴的方式來添加依賴。

  重要

  DataWorks不支援直接刪除已存在下遊依賴的節點輸出，直接刪除將導致下遊任務執行或取數異常。建議您先調整下遊業務，在下遊節點移除該上遊依賴，再在上遊節點刪除該節點輸出。

• 不納入自動解析的情境

  DataWorks中的暫存資料表（即工作空間表管理中定義的固定格式的表。例如，t_開頭的表），不會被自動解析為本節點的輸出或依賴的上遊節點。

• 自動解析使用注意事項

  使用自動解析設定依賴關係時，需保證節點輸出在當前地區下唯一。在DataWorks開發情境下，使用自動解析需注意以下問題：

  • 節點建立：節點預設內建一個同名的節點輸出，若同一個工作空間存在同名節點，需手動修改其中一個節點的節點輸出。

  • 代碼開發：自動解析會將節點的產出表作為節點輸出。若同一個工作空間中，兩個調度節點往同一張表插入資料，自動解析情境下將導致其中一個節點產生報錯，詳情請參見多個節點往同一張表寫資料，自動解析報錯節點輸出名相同。

  • 依賴配置 ：對於使用SQL任務加工離線同步任務的產出表的情境，為了方便SQL任務對離線同步任務產出表進行加工時，可通過血緣自動解析快速依賴離線同步任務，您需手動將離線同步節點的產出表配置為節點輸出，或者將離線同步任務產出表名作為離線同步任務節點名（平台會自動建立與節點名相同的節點輸出），否則下遊SQL節點提交時可能報錯當前節點依賴的父節點輸出名${projectname.tablename}不存在，不能提交本節點，請確保擁有該輸出名的父節點已被提交。

通過調度配置介面手動添加上遊節點依賴

在調度配置->調度依賴->依賴的上游節點配置介面，通過輸入某節點的節點輸出/節點名稱/節點ID，手動添加依賴的上遊節點。節點名稱容易出現重複，推薦使用節點輸出進行依賴掛載。

通過商務程序面板拉線設定節點依賴

在商務程序的DAG面板使用拉線方式設定依賴關係時，DataWorks將自動為下遊節點添加上遊節點_out格式的輸出，形成節點依賴。