大数据开发治理平台 DataWorks：Shell节点

节点开发

1. 登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的数据开发与运维 > 数据开发，在下拉框中选择对应工作空间后单击进入数据开发。

2. 在数据开发（Data Studio）页面，新建Shell节点。

3. 在脚本编辑区内输入标准shell代码（不支持交互式语法）：

   echo "Hello DataWorks!"

4. 完成代码开发后，在右侧单击运行配置，选择目标调试资源组及其他必要执行参数，随后单击运行按钮，触发本地化调试执行。

5. 脚本通过调试验证后，需在右侧单击调度配置，完成调度周期、依赖关系、参数设置等生产级调度策略配置，以支撑节点按计划周期性自动执行。

6. 完成任务调度配置后，需对节点进行保存后，才可进行下一步操作。

节点发布与运维

1. 完成调度配置后，可将Shell节点提交发布至生产环境，实现从开发态到生产态的正式部署。具体操作及发布流程，请参见：节点/工作流发布。

2. 发布成功后，任务将按照您配置的调度进行周期运行。您可通过单击左上角图标，在弹出导航页中依次选择全部产品 > 数据开发与运维 > 运维中心，进入运维中心，随后在左侧菜单栏定位至任务运维 > 周期任务运维 > 周期任务，即可查看已发布的周期任务。详细功能说明请参见：运维中心入门。

引用资源

1. DataWorks支持通过资源管理将需要在Shell节点中使用的资源上传至DataWorks，详情请参见资源管理。

   说明

   资源需要发布后才可被节点引用。若生产任务需使用该资源，还需将该资源发布至生产环境。

2. 打开已创建的Shell节点进入脚本编辑页面。

3. 单击左侧导航栏中的，进入资源管理菜单，然后找到需要引用的资源。选中资源后，右键选择引用资源，即可在Shell脚本中引用该资源。

   

   说明

   • 引用成功后，系统将自动在脚本顶部插入形如##@resource_reference{resource_name} 的声明注释。

   • 该注释是 DataWorks 识别资源依赖、在任务运行时自动挂载对应资源至执行环境的必要标识，请勿手动修改或删除。

使用调度参数

调度参数以位置参数形式注入 Shell 节点，不支持自定义变量名：DataWorks 将您在节点调度配置 > 调度参数中设置的参数值，按顺序作为 $1、$2、$3 … 等位置参数传递给 Shell 脚本。当参数数量超过9时，需使用 ${10}、${11} 等大括号语法以确保正确解析。多个参数值需用空格分隔，且顺序必须与脚本中引用的位置严格一致。

例如，本示例中：

• 参数$1赋值为当前时间：$[yyyymmdd]。

• 参数$2赋值为固定值：Hello DataWorks。

使用ossutil访问OSS

DataWorks Shell节点原生支持阿里云OSS命令行工具 ossutil，支持Bucket 管理、文件上传/下载、批量操作等任务。您可通过配置文件方式或命令行参数方式配置访问凭证使用ossutil访问OSS。

• 通过命令行参数方式使用ossutil访问OSS，详情可参见：命令行参数方式访问OSS。

• 通过配置文件方式使用ossutil访问OSS，详情可参见：配置文件方式访问OSS。

特别地，在新版数据开发中，针对Shell节点，除了上述两种方式，其支持通过绑定RAM角色，利用阿里云 STS（Security Token Service）动态获取该角色的临时安全凭证，并使用ossutil访问OSS。此方式无需在代码中明文配置长期有效的 AccessKey，即可安全地获得访问目标云资源的权限。详情请参见相关文档：配置节点关联角色。

使用数据集访问OSS/NAS

DataWorks支持创建OSS或NAS类型的数据集，然后在Shell节点开发中使用数据集，实现Shell节点运行过程中读写OSS或NAS存储中的数据。

通过关联角色运行节点

支持配置节点关联角色，使用特定RAM角色运行节点任务，实现权限的细粒度控制和安全管控。