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

背景信息

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

操作步骤

  1. 新增节点插件。
    1. 登录DataWorks控制台
    2. 在左侧导航栏,单击工作空间列表
    3. 选择工作空间所在地域后,单击相应工作空间后的进入数据开发
    4. 单击页面右上方的节点配置,默认进入节点插件列表
    5. 节点插件列表页面,单击右上方的新增
    6. 请选择插件类型对话框中,选中需要新增的类型(示例为引擎型),单击确认
      插件类型包括引擎型业务型
      • 引擎型:通过上传JAR或其它格式的代码包定义插件的功能,通常用于驱动自定义计算引擎。
      • 业务型:以开发手动业务流程的方式定义插件的功能,通常用于封装多个基础节点实现特定的业务逻辑。
  2. 基本设置页面,配置各项参数。
    基本设置
    参数 描述
    名称 插件的名称。仅支持字母、下划线(_)和数字,且以字母开头。
    负责人 根据工作空间的成员进行选择。当选择其他用户时:
    • 如果您是项目管理员,则不能编辑其他用户的自定义插件。
    • 如果您是项目所有者,则可以编辑其他用户的插件。
    资源文件 包括上传本地文件使用OSS文件AppStudio三种方式。
    说明
    • 仅选择引擎型的插件类型时,显示该参数。
    • 本地文件上传方式最大支持50 MB,OSS下载方式最大支持200 MB。

    单击选择文件,在上传文件对话框中选择相应的方式并进行配置,单击确认

    类名 插件实现的类的全路径名称。
    说明 仅选择引擎型的插件类型时,显示该参数。
    参数模板 根据您上传的资源文件设计您的参数内容。
    说明 仅选择引擎型的插件类型时,显示该参数。
    手动业务流程 单击选择手动业务流程,在下拉列表中选择需要的手动业务流程名称,单击确认
    说明 仅选择业务型的插件类型时,显示该参数。
    版本号 新增时,请选择使用新版本。编辑和回滚时,请选择覆盖当前版本。
    版本描述 对插件进行简单描述。
  3. 单击保存后,再单击下一步
    单击保存后,您可以保存修改的配置至数据库:
    • 如果修改的是基本信息(非插件包),您只需要保存即可生效,无需进行发布。
    • 如果修改的是JAR包,您必须进行发布才会生效。
  4. 发布到开发环境页面,确认内容无误后,单击提交开发环境发布,实时查看发布进度
  5. 发布成功后,单击下一步
  6. 在开发环境测试插件。
    1. 在开发环境测试页面,输入参数环境变量代码
    2. 单击开始测试
    3. 确认测试结果无误后,选中已检查,确认测试通过
    4. 单击下一步
  7. 发布到生产环境页面,单击提交生产环境发布,实时查看发布进度
    说明 提交至生产环境的版本必须是在开发环境已经部署、测试通过的最新版本,否则生产环境会提示发布失败。
  8. 单击完成,进入插件列表
    您可以在该页面查看新建的插件,并进行配置查看全部版本删除等操作:
    • 配置:单击配置后,会根据插件的状态,自动跳转至相应的页面。
    • 查看全部版本:单击查看全部版本,在全部版本对话框中,查看、回滚或下载插件的版本,单击确认
      • 查看:单击后进入新增节点插件的基本信息页面。
      • 回滚:提示使用旧版JAR和配置重新发布插件,但会更新版本号。回滚的版本号为全部版本页面中最大的版本号+1。
      • 下载:单击下载,即可下载对应的资源文件。
    • 删除:单击删除,在删除插件对话框中,单击确认
      注意 仅支持删除没有节点关联的插件。