全部產品
Search
文件中心

DataWorks:配置代碼模板

更新時間:Sep 05, 2026

代碼模板是在建立節點後,預設展示在該節點代碼編輯器介面最前端的內容,包括節點類型、節點的建立使用者、節點的建立時間等資訊,協助您快速標記該節點。通常用於業務層進行節點管理。本文為您介紹DataWorks支援的代碼模板類型及如何設定代碼模板。

使用限制

僅空間管理員可以修改代碼模板。如果目標使用者需要修改代碼模板,則可被授予空間管理員角色許可權,授權詳情請參見增加空間成員並管理成員角色許可權。

設定代碼模板

  1. 進入代碼模板。

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

    2. 單擊左側導覽列底部的設定表徵圖,進入設置頁面。

    3. 在設置頁面,單擊切換至代碼模板頁簽,進入代碼模板頁面。

  2. 設定代碼模板。

    在代碼模板頁面,單擊相應代碼類型後的編輯,即可根據需要修改該類型節點的代碼模板。修改並儲存後,後續在資料開發(DataStudio)建立的相應節點便會呈現該模板的配置內容,您可基於該內容進行相關業務管理操作。DataWorks支援的模板類型,請參見支援的代碼模板類型。

    以ODPS SQL節點樣本,該節點編輯頁面代碼模板展示如下。

    --odps sql
    --**********************************************************
    --author: xxx
    --create time:2023-06-26 11:33:05
    --**********************************************************

支援的代碼模板類型

在定義代碼模板時,您可使用相關變數來記錄建立該類型任務時的相關資訊,目前支援在模板中定義的變數有:

  • author:記錄節點建立人。

  • createTime:記錄節點建立時間。

DataWorks支援的節點類型及為該節點提供的預設範本如下表。

引擎類型

節點類型

預設模

MaxCompute

ODPS Script

ODPS Script 代碼模板包含以下模板變數:${author}(作者)和 ${createTime}(建立時間),格式以注釋分隔線包裹。

ODPS SQL

ODPS SQL 代碼模板的預設內容包含注釋行 --odps sql,以及模板變數 ${author}(作者)和 ${createTime}(建立時間),各行之間以星號分隔線隔開。編輯完成後單擊儲存。

ODPS MR

ODPS MR 代碼模板預設內容為 -odps mr,並包含 ${author}(作者)和 ${createTime}(建立時間)兩個變數預留位置。在彈窗中編輯完成後,單擊儲存即可。

PyODPS 2

PyODPS 2 代碼模板預設內容為英文提示資訊:Please try your best avoiding downloading massive data from MaxCompute. Related methods are open_reader of tables or instances, and to_pandas of DataFrames. It is recommended to use PyODPS DataFrame created from MaxCompute tables, or MaxCompute SQL directly. Reference: https://developer.aliyun.com/article/745029。可在彈窗中編輯模板內容後單擊儲存,或單擊取消放棄修改。

PyODPS 3

PyODPS 3 代碼模板內容為英文提示資訊:Please try your best avoiding downloading massive data from MaxCompute. Related methods are open_reader of tables or instances, and to_pandas of DataFrames. It is recommended to use PyODPS DataFrame created from MaxCompute tables, or MaxCompute SQL directly. Reference: https://developer.aliyun.com/article/745029。

EMR

EMR MR

--EMR MR
--**********************************************************--
--author:${author}
--create time:${createTime}
--EMR MR node can only run on exclusive resource groups.
--**********************************************************--

EMR Shell

EMR Shell 代碼模板內容包含模板變數 ${author} 和 ${createTime},並提示 EMR Shell 節點只能在獨享資源群組上運行。

EMR Presto

EMR Presto 代碼模板內容包含以下模板變數和提示資訊:--author:${author}、--create time:${createTime} 和 --EMR Presto node can only run on exclusive resource groups.。

EMR Spark Streaming

--EMR Spark Streaming
--***************************************************--

--author:${author}
--create time:${createTime}
--EMR Spark Streaming node can only run on exclusive resource groups.
--***************************************************--

EMR Trino

EMR Trino 代碼模板內容為 --EMR Trino 標題列、--author:${author} 作者變數預留位置、--create time:${createTime} 建立時間變數預留位置,以及提示資訊 EMR Trino node can only run on exclusive resource groups.。

EMR Hive

EMR Hive 節點的代碼模板內容包含以下模板變數和提示資訊:${author}(作者)、${createTime}(建立時間),以及提示 EMR Hive node can only run on exclusive resource groups.。

EMR Spark

--EMR Spark
--*******************************************--
--author:${author}
--create time:${createTime}
--EMR Spark node can only run on exclusive resource groups.
--*******************************************--

EMR Spark SQL

EMR Spark SQL 的預設代碼模板內容包含註解區塊,其中定義了 ${author}(作者)和 ${createTime}(建立時間)兩個變數,並提示 EMR Spark SQL node can only run on exclusive resource groups.(EMR Spark SQL 節點僅支援在獨享資源群組上運行)。

CDH

CDH Hive

--CDH Hive
--*************************************************************--
--author:${author}
--create time:${createTime}
--CDH Hive node can only run on exclusive resource groups.
--*************************************************************--

CDH Spark

--CDH Spark
--**********************************************************--
--author:${author}
--create time:${createTime}
--CDH Spark node can only run on exclusive resource groups.
--**********************************************************--

CDH MR

--CDH MR
--**********************************************************************--
--author:${author}
--create time:${createTime}
--CDH MR node can only run on exclusive resource groups.
--**********************************************************************--

CDH Presto

--CDH Presto
--**********************************************************--
--author:${author}
--create time:${createTime}
--CDH Presto node can only run on exclusive resource groups.
--**********************************************************--

CDH Impala

CDH Impala 代碼模板內容包含以下變數和提示資訊:${author}(作者)、${createTime}(建立時間),並提示 CDH Impala 節點只能在獨享資源群組上運行。

Hologres

Hologres SQL

Hologres SQL 代碼模板預設包含注釋頭,使用 ${author} 和 ${createTime} 變數自動填滿作者和建立時間。

其他

Shell

#!/bin/bash
#************************************************************#
##author:${author}
##create time:${createTime}
#************************************************************#

ClickHouse SQL

ClickHouse SQL 代碼模板內容樣本:頂部和底部為星號分隔線,中間包含兩個模板變數 --author:${author} 和 --create time:${createTime}。編輯完成後單擊儲存。

HTTP觸發器

--HTTP Trigger
--**********************************************************--

--author:${author}
--create time:${createTime}
--HTTP Trigger is a kind of virtual node. It can trigger its child nodes when you calling the
DataWorks OpenAPI "RunTriggerNode".
--HTTP Trigger is usually used to linking with user's system
--See details here: https://www.alibabacloud.com/help/document_detail/190911.html

--**********************************************************--