DataWorks：使用流程參數

支援的節點類型

當前僅ODPS SQL、EMR Spark Shell、EMR Spark、EMR Shell、EMR Hive、EMR MR、EMR Presto、EMR Trino、EMR Spark SQL、EMR Spark Streaming、EMR Streaming SQL、Hologres SQL節點支援使用流程參數，具體請以實際介面為準。

注意事項

• 配置並儲存流程參數後，每次開啟節點（即當前商務程序下支援使用流程參數的節點）時，都會載入商務程序中最新的流程參數至節點的參數配置列表，節點將回到編輯狀態，需提交發布節點後，新的流程參數配置才會在調度情境下生效。

• 當同一參數在流程參數的賦值與單個節點中的賦值不一致時，流程參數的賦值會覆蓋節點中的參數賦值。

• 流程參數在進行參數賦值時，參數值或運算式不支援配置為${英文}：格式。例如：var：1、${var}：1。

流程參數配置入口

1. 進入資料開發頁面。

   登入DataWorks控制台，切換至目標地區後，單擊左側導覽列的資料建模與開發 > 資料開發，在下拉框中選擇對應工作空間後單擊進入資料開發。

2. 進入流程參數配置介面。

   雙擊目標商務程序，在商務程序編輯頁面右側導覽列配置流程參數。

配置流程參數

支援使用流程參數的節點，其參數配置方式相同。通常，當需要批量為商務程序下節點的某參數賦值時，建議使用該功能。本文樣本通過流程參數，將周期商務程序中ODPS SQL節點的ReplaceMe參數取值20230613替換為20230615，為您介紹流程參數的使用。

1. 開發節點配置節點參數。

   1. 進入節點編輯頁面。

      雙擊目標商務程序下的ODPS SQL節點，進入節點編輯頁面。

   2. 配置節點參數。

      如下圖，配置ODPS SQL節點參數取值為20230613。更多節點參數的配置，詳情請參見配置調度參數。

2. 使用流程參數替換開發節點中的參數取值。

   1. 雙擊目標商務程序，在商務程序編輯頁面，單擊右側導覽列的流程參數。

   2. 在流程參數對話方塊配置參數資訊。

      如下圖，樣本配置流程參數取值為20230615，儲存配置後，商務程序中ODPS SQL節點的參數取值將替換為20230615。您也可根據業務需求，新增多個參數使用。

      說明

      • 當同一參數在流程參數的賦值與單個節點中的賦值不一致時，流程參數的賦值會覆蓋節點中的參數賦值。

      • 流程參數在進行參數賦值時，參數值或運算式不支援配置為${英文}：格式。例如：var：1、${var}：1。

      ODPS SQL節點參數替換情況。

驗證流程參數是否生效

流程參數配置完成後，您需運行商務程序，驗證流程參數配置的參數取值是否已替換節點中配置的參數取值。

1. 運行商務程序並為變數賦值。

   運行商務程序時，當使用了流程參數，您需手動為流程參數進行賦值。更多運行方式介紹，詳情請參見任務調試運行。

   1. 在商務程序編輯頁面，單擊工具列中的表徵圖。

   2. 在填寫參數對話方塊中為變數ReplaceMe賦值20230615。

2. 查看運行結果。

   在商務程序編輯頁面，按右鍵ODPS SQL節點，選擇查看日誌，即可在頁面下方查看ODPS SQL節點的賦值情況。此時節點的參數取值已由20230613變更為20230615，流程參數生效且運行無誤。

提交發布流程參數

確認流程參數配置無誤後，您需提交發布當前商務程序，提交發布後，流程參數才會真正生效。

1. 提交商務程序。

   您需按下圖步驟提交商務程序，提交時，請選擇需要提交的節點並配置相關描述資訊。

   說明

   可根據需要選擇是否使用程式碼檢閱，若使用，則當前提交的節點代碼必須通過評審人員的審核才可發布。

   

2. 發布商務程序。

   如果您使用的是標準模式的工作空間，提交成功後，需單擊右上方的發布，發布商務程序中的節點，具體操作請參見發布任務。