数据推送节点

数据推送节点可将Data Studio业务流程中其他节点产生的数据查询结果,通过新建数据推送目标,将数据推送至钉钉群、飞书群、企业微信群、Teams以及邮件,便于团队成员及时接收和关注最新数据情况。

背景信息

数据推送节点可以通过节点上下文参数获取上游数据查询SQL节点(赋值节点、Hologres SQL节点、ClickHouse SQL节点等)的输出参数,并将这些参数以占位符等形式在推送正文中进行编辑,编辑完成后推送至目标。

image
  • 上游数据查询SQL节点查询完成后,将结果生成名为outputs的节点输出参数。

  • 在下游数据推送节点中通过节点上下文参数获取outputs上游节点输出参数信息,并绑定为数据推送节点的节点输入参数。

  • 在数据推送节点配置引用节点输入参数为推送内容,并设置推送目标后,进行内容推送。

支持的上游数据查询SQL节点

前提条件

使用限制

  • 数据推送功能推送至不同对象时的数据大小限制。

    推送目标

    推送限制

    钉钉

    推送数据大小不超过20KB。

    飞书

    推送数据大小不超过20KB,图片小于10MB

    企业微信

    每个机器人发送的消息不能超过20条/分钟

    Teams

    推送大小不大于28KB。

    邮件

    每个数据推送任务仅支持添加一个邮件正文,若已添加邮件正文,则无法再次添加,更多限制可参考所使用邮件服务的SMTP限制。

  • 数据推送支持地域:

    华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华南1(深圳)、西南1(成都)、中国香港、新加坡、美国(硅谷)、美国(弗吉尼亚)、德国(法兰克福)

进入数据开发

  1. 进入DataWorks工作空间列表页,在顶部切换至目标地域,找到已创建的工作空间,单击操作列的快速进入 > Data Studio,进入Data Studio。

  2. 在左侧导航栏单击image图标,进入数据开发页面。

新建推送链路

新建配置数据查询SQL节点及数据推送节点链路。

  1. 新建周期工作流,在工作流中新建数据查询SQL节点和数据推送节点。

  2. 新建数据查询SQL节点,并在节点中添加需查询推送的SQL代码。

    说明
    • 数据推送节点暂不支持直接从ODSP SQL中获取查询数据,您可以新建赋值节点,并在赋值节点中查询需要推送的结果信息。

    • 其他数据查询SQL节点可正常创建。

  3. 配置数据查询SQL节点。

    需在节点右侧调度配置中配置计算资源调度资源组同周期依赖信息(如无上游节点,可勾选使用工作空间根节点)。输出参数配置区别如下:

    节点类型

    配置说明

    赋值节点

    赋值节点默认存在节点输出参数,无需配置节点输出参数。

    其他数据查询SQL节点

    其他数据查询SQL节点没有默认的节点输出参数信息,您需在节点右侧调度配置节点上下文参数中找到节点输出参数,单击添加赋值参数,才能将当前查询结果通过参数传递到下游数据推送节点。

  4. 新建数据推送节点,并配置引用数据查询SQL节点为上游节点。

    1. 单击调度配置,在调度依赖 > 同周期依赖根据节点名称单击添加,将上面创建的数据查询SQL节点添加为数据推送节点的上游节点。

    2. 调度策略 > 调度资源组选择创建的Serverless资源组。

    3. 节点上下文参数 > 节点输入参数单击添加参数,将数据查询SQL节点的输出参数作为取值来源添加为数据推送节点的输入参数

配置推送目标及内容

在数据推送节点编辑页面中,自定义推送标题,并配置推送目标及正文内容。

配置推送目标

数据推送目标选择目标源。

  1. 若目标源不存在,可单击创建数据推送目标。也可在数据服务中设置数据推送目标

    说明

    如需修改数据推送目标,仅支持在数据服务数据推送中进行相应修改。

  2. 进入新建推送目标页面,根据以下信息创建数据推送目标。

    新建钉钉、飞书、企业微信及Teams推送目标

    参数

    配置说明

    数据推送目标

    选择钉钉飞书企业微信Teams

    目标名称

    可根据业务需求进行自定义。

    Webhook

    根据所选的数据推送目标,获取并配置对应的Webhook信息。

    新建邮箱推送目标

    参数

    配置说明

    数据推送目标

    选择邮件

    SMTP Host

    SMTP服务器的地址,用于发送邮件。

    SMTP Port

    SMTP服务器的端口号,用于连接邮件服务器。默认为465,可手动修改。

    发信地址

    邮件发送地址。

    发信昵称

    非必填,自定义发信人昵称。

    SMTP账号

    用于登录SMTP服务器的邮箱账号。

    SMTP密码

    用于验证SMTP账号身份的密码。

    接收地址

    邮件接收方的邮箱地址,多个地址可用逗号分隔。

配置推送正文

可通过Markdown、表格、邮件正文三种方式配置正文信息。

  • 数据推送正文中的Markdown可以直接使用数据推送节点的节点输入参数的参数名作为占位符${节点输入参数名},获取上游输出的参数。

  • 数据推送正文中的表格,可通过上游数据查询SQL节点的字段名作为关联参数获取数据。

  • DataWorks数据推送中,支持在推送内容中添加邮件正文,编辑邮件正文内容时,需注意以下事项:

    • 每个数据推送任务仅支持添加一个邮件正文。

    • 邮件正文仅在推送目标为邮件时进行渲染此正文内容,推送目标非邮件时,邮件正文将会在Webhook推送的消息中被隐藏。

调试运行数据推送

配置完成后,保存数据查询SQL节点和数据推送节点后,您可单击工作流上方工具栏中的image图标,调试运行数据推送任务。

后续步骤

  • 节点调度:若项目目录下的节点需要周期性调度执行,您需要在节点右侧的调度配置中设置调度策略,配置相关的调度属性。

  • 节点发布:若任务需要发布至生产环境执行,请单击界面image图标唤起发布流程,通过该流程将任务发布至生产环境。项目目录下的节点只有在发布至生产环境后,才会进行周期性调度。