Apache DolphinScheduler 使用文檔（7/8）：系統參數及自定義參數

本文章經授權轉載，原文鏈接：

https://blog.csdn.net/MiaoSO/article/details/104770720

目錄

7. 參數

• 7.1 系統參數

• 7.2 時間自定義參數

• 7.3 用戶自定義參數

---

7. 參數

7.1 系統參數

• ${system.biz.date} : 日常調度實例定時的定時時間前一天，格式為 yyyyMMdd，補數據時，該日期 +1

• ${system.biz.curdate} : 日常調度實例定時的定時時間，格式為 yyyyMMdd，補數據時，該日期 +1

• ${system.datetime} : 日常調度實例定時的定時時間，格式為 yyyyMMddHHmmss，補數據時，該日期 +1

7.2 時間自定義參數

時間自定義參數支持代碼中自定義變量名，聲明方式：${變量名}。可以是引用 "系統參數" 或指定 "常量"。

我們定義這種基准變量為 [...] 格式的，[yyyyMMddHHmmss] 是可以任意分解組合的，比如：$[yyyyMMdd], $[HHmmss], $[yyyy-MM-dd] 等。

例：

• 后 N 年：$[add_months(yyyyMMdd,12*N)]

• 前 N 年：$[add_months(yyyyMMdd,-12*N)]

• 后 N 月：$[add_months(yyyyMMdd,N)]

• 前 N 月：$[add_months(yyyyMMdd,-N)]

• 后 N 周：$[yyyyMMdd+7*N]

• 前 N 周：$[yyyyMMdd-7*N]

• 后 N 天：$[yyyyMMdd+N]

• 前 N 天：$[yyyyMMdd-N]

• 后 N 小時：$[HHmmss+N/24]

• 前 N 小時：$[HHmmss-N/24]

• 后 N 分鍾：$[HHmmss+N/24/60]

• 前 N 分鍾：$[HHmmss-N/24/60]

7.3 用戶自定義參數

用戶自定義參數分為全局參數和局部參數。
全局參數是保存工作流定義和工作流實例的時候傳遞的全局參數，全局參數可以在整個流程中的任何一個任務節點的局部參數引用。

例：

項目管理 -> 工作流 -> 工作流定義 -> 創建工作流
------------------------------------------------------
拖拽 Shell 節點到畫布，新增一個 Shell 任務
節點名稱：Test_parameters
... ...
腳本：
    #!/bin/sh
    echo "---------------------------------------"
    echo "# 時間自定義參數"
    echo "后 1 年：" $[add_months(yyyyMMdd, 12*1)]
    echo "前 1 年：" $[add_months(yyyyMMdd, -12*1)]
    echo "后 1 月：" $[add_months(yyyyMMdd,1)]
    echo "前 1 月：" $[add_months(yyyyMMdd,-1)]
    echo "后 1 周：" $[yyyyMMdd+7*1]
    echo "前 1 周：" $[yyyyMMdd-7*1]
    echo "后 1 天：" $[yyyyMMdd+1]
    echo "前 1 天：" $[yyyyMMdd-1]
    echo "后 1 小時：" $[HHmmss+1/24]
    echo "前 1 小時：" $[HHmmss-1/24]
    echo "后 1 分鍾：" $[HHmmss+1/24/60]
    echo "前 1 分鍾：" $[HHmmss-1/24/60]

    echo "---------------------------------------"
    echo "# 用戶自定義參數"
    echo "dt_yesterday: " ${dt_yesterday}
    echo "dt_datetime: " ${dt_datetime}
    echo "dt_today: " ${dt_today}
    echo "dt_today_global: " ${dt_today_global}

資源：
自定義參數：
    dt_yesterday    ${system.biz.date}
    dt_datetime     ${system.datetime}
    dt_today        ${system.biz.curdate}
-> 確認添加
------------------------------------------------------
保存 ->
設置 DAG 圖名稱：Test_parameters
選擇租戶：Default
超時告警：off
設置全局：
    dt_today_global ${system.biz.curdate}
------------------------------------------------------
添加 -> 上線 -> 運行

---

文章目錄：
DS 1.2.0 使用文檔（1/8）：架構及名詞解釋
DS 1.2.0 使用文檔（2-3/8）：集群規划及環境准備
DS 1.2.0 使用文檔（4/8）：軟件部署
DS 1.2.0 使用文檔（5/8）：使用與測試
DS 1.2.0 使用文檔（6/8）：任務節點類型與任務參數設置
DS 1.2.0 使用文檔（7/8）：系統參數及自定義參數
DS 1.2.0 使用文檔（8/8）：附錄