全部产品
Search
文档中心

大数据开发治理平台 DataWorks:配置代码模板

更新时间:Sep 04, 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

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