新增节点插件

新增节点插件包括基本设置、发布到开发环境、在开发环境测试和发布到生产环境四个步骤。

背景信息

插件是节点的核心处理逻辑,目前仅支持Java语言。以ODPS SQL节点为例,您在编辑器中编写的SQL,提交运行后,会使用后台对应的插件来解析并执行。新增一个自定义节点,首先需要开发自定义插件的处理逻辑。

操作步骤

  1. 新增节点插件。

    1. 登录DataWorks控制台,单击左侧导航栏的数据建模与开发 > 数据开发,在下拉框中选择对应工作空间后单击进入数据开发

    2. 单击页面右上方的节点配置,默认进入节点插件列表

    3. 节点插件列表页面,单击右上方的新增

    4. 请选择插件类型对话框中,选中需要新增的类型(示例为引擎型),单击确认

      插件类型包括引擎型业务型

      • 引擎型:通过上传JAR或其它格式的代码包定义插件的功能,通常用于驱动自定义计算引擎。

      • 业务型:以开发手动业务流程的方式定义插件的功能,通常用于封装多个基础节点实现特定的业务逻辑。

  2. 基本设置页面,配置各项参数。

    基本设置

    参数

    描述

    名称

    插件的名称。仅支持字母、下划线(_)和数字,且以字母开头。

    负责人

    根据工作空间的成员进行选择。当选择其他用户时:

    • 如果您是项目管理员,则不能编辑其他用户的自定义插件。

    • 如果您是项目所有者,则可以编辑其他用户的插件。

    资源文件

    包括上传本地文件使用OSS文件、AppStudio三种方式。

    说明
    • 仅选择引擎型的插件类型时,显示该参数。

    • 本地文件上传方式最大支持50 MB,OSS下载方式最大支持200 MB。

    类名

    插件实现的类的全路径名称。

    说明

    仅选择引擎型的插件类型时,显示该参数。

    参数模板

    根据您上传的资源文件设计您的参数内容。

    说明

    仅选择引擎型的插件类型时,显示该参数。

    手动业务流程

    单击选择手动业务流程,在下拉列表中选择需要的手动业务流程名称,单击确认

    说明

    仅选择业务型的插件类型时,显示该参数。

    版本号

    新增时,请选择使用新版本。编辑和回滚时,请选择覆盖当前版本。

    版本描述

    对插件进行简单描述。

  3. 单击保存后,再单击下一步

    单击保存后,您可以保存修改的配置至数据库:

    • 如果修改的是基本信息(非插件包),您只需要保存即可生效,无需进行发布。

    • 如果修改的是JAR包,您必须进行发布才会生效。

  4. 发布到开发环境页面,确认内容无误后,单击提交开发环境发布,实时查看发布进度

  5. 发布成功后,单击下一步

  6. 在开发环境测试插件。

    1. 在开发环境测试页面,输入参数环境变量代码

    2. 单击开始测试

    3. 确认测试结果无误后,选中已检查,确认测试通过

    4. 单击下一步

  7. 发布到生产环境页面,单击提交生产环境发布,实时查看发布进度

    说明

    提交至生产环境的版本必须是在开发环境已经部署、测试通过的最新版本,否则生产环境会提示发布失败。

  8. 单击完成,进入插件列表

    您可以在该页面查看新建的插件,并进行配置查看全部版本删除等操作:

    • 配置:单击配置后,会根据插件的状态,自动跳转至相应的页面。

    • 查看全部版本:单击查看全部版本,在全部版本对话框中,查看、回滚或下载插件的版本,单击确认

      • 查看:单击后进入新增节点插件的基本信息页面。

      • 回滚:提示使用旧版JAR和配置重新发布插件,但会更新版本号。回滚的版本号为全部版本页面中最大的版本号+1。

      • 下载:单击下载,即可下载对应的资源文件。

    • 删除:单击删除,在删除插件对话框中,单击确认

      重要

      仅支持删除没有节点关联的插件。