DataWorks：情境：切換調度時區

支援修改調度時區的地區

DataWorks部分地區目前支援多調度時區切換，支援修改調度時區的地區及各地區支援切換的時區如下。

（必讀）時區切換注意事項

為避免時區切換導致線上業務出錯或不符合預期，執行時區切換前請務必仔細閱讀以下內容。

時區切換產品側行為重點

一、節點定時時間

二、節點時間參數配置

節點調度參數會按照任務相關時間（任務定時時間，業務日期等）為基準值替換代碼中的變數，該值會根據的調度時區的改變而改變。

YYYYMMDD=${yyyymmdd} LAST_2D=${yyyymmdd-2}

三、節點代碼中時間相關的處理邏輯

代碼裡面設定的變數，一部分會在gateway解析，另一部分會在計算引擎側解析，具體解析邏輯如下：

• 如果是在gateway上解析的，會按照設定的調度時區變化。調度情境下（不包括資料開發臨時運行），若您在DataWorks指令碼任務（例如Shell，pyodps）中，直接執行擷取時間命令（例如Shell節點中執行date命令），系統會根據您調度時區返回時間。

• 如果是在底層計算引擎側解析的，請參考底層計算引擎側的時區轉換規則進行瞭解，具體請參見對應引擎說明文檔。

以下圖為例，調度情境下，代碼中的時間變數將根據調度時間替換為具體的時間字串下發至Hive，具體表達的時間，受限於Hive服務端解析邏輯。

四、基準或警示相關的時間

基準或警示相關的時間會按照設定的調度時區變化。

五、API相關的時間

API相關的時間會按照設定的調度時區變化。

六、底層引擎的時區

底層引擎（例如，Data Integration、MaxCompute等）的時區是由各自引擎自己設定的，與DataWorks調度時區不轉換。調度參數實際替換值將按照純字串形式下發至引擎側按自身規則自行處理，關於引擎處理方案請參考引擎時區的相關說明文檔。

如何切換時區

DataWorks調度支援從本地時區切換到其他非本地時區。

情境一：該租戶第一次建立專案

在支援切換時區的地區下建立工作空間時，若為全新使用者首次建立，會彈窗提示可修改調度時區為非本地時區，具體修改操作需要提交工單聯絡技術支援人員修改，您可根據業務需要以及（必讀）時區切換注意事項評估確認是否需要修改。

情境二：該租戶非第一次建立專案

在支援切換時區的地區下建立工作空間時，若需要將已有工作空間調度時區修改為非本地時區，您同樣需要提交工單聯絡技術支援人員修改，但由於涉及到存量資料的遷移（已經存在的節點和執行個體），可能對業務造成影響，請綜合評估。切換大致分為以下幾步：

1. 使用者側：存量資料的影響面評估。

2. 平台側：存量資料的遷移。

3. 平台側：設定新時區。

4. 使用者側：存量資料的恢複/新時區的驗證。

   建議您對各類型任務進行多次驗證以確認任務運行無誤。

確認時區切換是否成功

您可前往資料開發的調度配置頁面，確認時區是否切換成功，以及當前使用的調度時區。

1. 進入資料開發頁面。

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

2. 進入調度配置頁面。

   1. 在資料開發（DataStudio）介面，進入該專案的目標節點的編輯頁面。

   2. 單擊節點編輯頁面右側導覽列的調度配置，進入節點調度配置頁面。

3. 在調度配置頁面，顯示在時間屬性下面的就是當前所在的調度時區。

附錄：Data Integration相關時間處理

Data Integration的時區與DataWorks調度時區不轉換，調度參數實際替換值將按照純字串形式下發至Data Integration側。這裡以where條件資料過濾為例gmt_modify >= ${yyyymmdd}，這個資料過濾SQL會按照字串字面值發送給資料來源執行，實際執行過濾效果受限於資料來源本身時區處理機制。