DataWorks：各類型節點的調度參數配置樣本

SQL 類型節點（例如 ODPS SQL）和離線同步節點的調度參數配置方法相同，也適用於大多數其他節點類型。本文以ODPS SQL節點為例，為您展示如何為系統內建變數及自訂參數賦值，並在代碼中進行調用。

在參數賦值地區為參數賦值，然後進入代碼調用地區引用系統內建變數var1、var3，自訂參數var2、var4，常量var5。賦值樣本如下：

• 系統內建變數var1賦值取業務時間：var1=$bizdate

• 系統內建變數var3賦值取定時時間：var3=$cyctime

• 自訂參數var2賦值取業務時間：var2=${yyyymmdd}

• 自訂參數var4賦值取定時時間： var4=$[yyyymmddhh24:mi:ss]

• 常量var5參數賦值為abc：var5=abc

若需基於定時時間擷取相對時間（例如上一小時、前N分鐘），可在定時時間參數（$[...]）上進行位移計算：小時位移使用N/24，分鐘位移使用N/24/60，N為需要位移的小時或分鐘數。時、分位移僅定時時間支援，業務日期（${...}）不支援。以“擷取上一小時”為例，常用賦值樣本如下：

• 取定時時間的上一小時（完整時間，格式為yyyymmddhh24miss）：$[yyyymmddhh24miss-1/24]

• 僅取上一小時（24小時制小時）：$[hh24-1/24]

• 取上一小時的時分秒：$[hh24miss-1/24]

• 取年月日格式的前一小時：$[yyyymmdd-1/24]

• 取前一天且前一小時：$[yyyymmdd-1-1/24]

• 取定時時間的前15分鐘：$[yyyymmddhh24miss-15/24/60]

為避免代碼入侵，PyODPS節點不支援在代碼中直接使用${param_name}格式的字串替換定義的變數。執行代碼前，您需要從類型為dict（字典對象）的args全域變數中擷取調度參數，參數賦值方式與其他節點相同。

在 PyODPS 節點的代碼編輯器中，通過 args 字典引用調度參數（如 args['var1']、args['var2']、args['var3']），並使用 print 輸出參數值。在右側調度配置面板的調度參數地區為這些參數賦值。

在參數賦值地區為參數賦值，然後進入代碼調用地區引用內建參數var1，自訂參數var2、var3。添加字典對象後的參數為args['var1']、args['var2'] 、args['var3']。賦值樣本如下：

• 內建參數var1賦值取業務時間：var1=$bizdate

• 自訂參數var2賦值取業務時間：var2=${yyyymmdd}

• 自訂參數var3賦值取業務時間： var3=$[yyyymmdd]

通用Shell節點中的變數不允許自訂命名，只能以$1、$2、$3...命名（參數序號由小到大，依次遞增），當參數的數量大於10時，請使用${10}的方式聲明變數。

Shell 節點中第 10 個及以後的參數需使用 ${10} 形式引用（如 echo ${10}）。

在參數賦值地區為參數賦值，然後進入代碼調用地區定義內建參數$1，自訂參數$2、$3。賦值樣本如下：

• 內建參數$1賦值取業務時間：$bizdate

• 自訂參數$2賦值取業務時間：${yyyymmdd}

• 自訂參數$3賦值取定時時間： $[yyyymmdd]

關於調度參數支援的更多賦值格式，請參見調度參數支援的格式。要瞭解配置和使用調度參數的完整流程，請參見配置並使用調度參數。