DataWorks：Shell節點

節點開發

1. 登入DataWorks控制台，切換至目標地區後，單擊左側導覽列的數據開發與營運 > 数据开发，在下拉框中選擇對應工作空間後單擊進入資料開發。

2. 滑鼠移至上方至表徵圖，單擊建立節點 > 通用 > Shell，在建立節點對話方塊輸入節點名稱及路徑。

3. 在指令碼編輯區內輸入標準shell代碼（不支援互動式文法）：

   echo "Hello DataWorks!"

4. 完成代碼開發後，單擊，選擇目標資源群組和鏡像，執行通用Shell節點任務。

5. 指令碼通過調實驗證後，在右側單擊調度配置，完成調度時間屬性，資源屬性等生產級調度策略配置，以支撐節點按計劃周期性自動執行。配置節點調度屬性，詳情請參見節點調度配置。

節點發布與營運

1. 任務調度屬性配置完成後，您可提交節點至開發環境，並發布至生產環境進行周期性調度。

2. 發布成功後，任務將按照您配置的調度進行周期運行。您可通過單擊左上方表徵圖，在彈出導航頁中依次選擇全部產品 > 資料開發與營運 > 營運中心，進入營運中心，隨後在左側功能表列定位至任務營運 > 周期任務營運 > 周期任務，即可查看發行的周期任務。詳細功能說明請參見：營運中心入門。

引用資源

1. DataWorks支援通過資源管理將需要在Shell節點中使用的資源上傳至DataWorks，詳情請參見資源管理。

   說明

   資源需要提交後才可被節點引用。若生產任務需使用該資源，還需將該資源發布至生產環境。詳情請參見發布任務。

2. 在資料開發左側分類樹下找到已上傳的資源。

3. 按右鍵該資源，選擇引用資源，則該資源將被引用至當前節點中。您可在節點編輯頁面，通過編寫代碼運行該資源。

   

   說明

   引用成功後，系統將自動在指令碼頂部插入形如##@resource_reference{resource_name} 的聲明注釋。

   該注釋是 DataWorks 識別資源依賴、在任務運行時自動掛載對應資源至執行環境的必要標識，請勿手動修改或刪除。

使用調度參數

調度參數以位置參數形式注入 Shell 節點，不支援自訂變數名：DataWorks 將您在節點調度配置中設定的調度參數值，按順序作為 $1、$2、$3 … 等位置參數傳遞給 Shell 指令碼，當參數數量超過9時，需使用 ${10}、${11} 等大括弧文法以確保正確解析。多個參數值需用空格分隔，且順序必須與指令碼中引用的位置嚴格一致。

例如，本樣本中：

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

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

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

使用ossutil訪問OSS

DataWorks Shell節點原生支援阿里雲OSS命令列工具 ossutil，支援Bucket 管理、檔案上傳/下載、大量操作等任務。您可通過設定檔方式或命令列參數方式配置訪問憑證使用ossutil訪問OSS。

• 通過命令列參數方式使用ossutil訪問OSS，詳情可參見：命令列參數方式訪問OSS。

• 通過設定檔方式使用ossutil訪問OSS，詳情可參見：設定檔方式訪問OSS。

附錄：指令碼退出碼說明

根據指令碼退出碼可進一步判斷指令碼是否運行成功。

• 退出碼0：表示成功。

• 退出碼-1：表示進程被終止。

• 退出碼2：需要平台自動重跑一次任務。

• 其它退出碼：表示失敗。

下圖為Shell節點執行成功（退出碼為 0）時的標準作業記錄樣本。