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）时的标准运行日志示例。