数据推送节点可将Data Studio业务流程中其他节点产生的数据查询结果,通过新建数据推送目标,将数据推送至钉钉群、飞书群、企业微信群、Teams以及邮件,便于团队成员及时接收和关注最新数据情况。
背景信息
数据推送节点可以通过节点上下文参数获取上游数据查询SQL节点(赋值节点、Hologres SQL节点、ClickHouse SQL节点等)的输出参数,并将这些参数以占位符等形式在推送正文中进行编辑,编辑完成后推送至目标。
上游数据查询SQL节点查询完成后,将结果生成名为
outputs
的节点输出参数。在下游数据推送节点中通过节点上下文参数获取
outputs
上游节点输出参数信息,并绑定为数据推送节点的节点输入参数。在数据推送节点配置引用节点输入参数为推送内容,并设置推送目标后,进行内容推送。
支持的上游数据查询SQL节点:
赋值节点:暂不支持MaxCompute SQL数据查询SQL节点,如有需要,可通过创建赋值节点来查询MaxCompute相关数据。
其他SQL节点:Hologres SQL节点、ClickHouse SQL节点、EMR Spark SQL节点、EMR Hive节点、MaxCompute Script节点、ADB for PostgreSQL节点和MySQL节点。
前提条件
已创建工作空间。
已新增和使用Serverless资源组,并绑定到目标DataWorks工作空间。
使用限制
数据推送功能推送至不同对象时的数据大小限制。
推送目标
推送限制
钉钉
推送数据大小不超过20KB。
飞书
推送数据大小不超过20KB,图片小于10MB。
企业微信
每个机器人发送的消息不能超过20条/分钟。
Teams
推送大小不大于28KB。
邮件
每个数据推送任务仅支持添加一个邮件正文,若已添加邮件正文,则无法再次添加,更多限制可参考所使用邮件服务的SMTP限制。
数据推送支持地域:
华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华南1(深圳)、西南1(成都)、中国香港、新加坡、美国(硅谷)、美国(弗吉尼亚)、德国(法兰克福)。
进入数据开发
进入DataWorks工作空间列表页,在顶部切换至目标地域,找到已创建的工作空间,单击操作列的 ,进入Data Studio。
在左侧导航栏单击
图标,进入数据开发页面。
新建推送链路
新建配置数据查询SQL节点及数据推送节点链路。
新建周期工作流,在工作流中新建数据查询SQL节点和数据推送节点。
新建数据查询SQL节点,并在节点中添加需查询推送的SQL代码。
配置数据查询SQL节点。
需在节点右侧调度配置中配置计算资源、调度资源组和同周期依赖信息(如无上游节点,可勾选使用工作空间根节点)。输出参数配置区别如下:
节点类型
配置说明
赋值节点
赋值节点默认存在节点输出参数,无需配置节点输出参数。
其他数据查询SQL节点
其他数据查询SQL节点没有默认的节点输出参数信息,您需在节点右侧调度配置的节点上下文参数中找到节点输出参数,单击添加赋值参数,才能将当前查询结果通过参数传递到下游数据推送节点。
已新建数据推送节点,并配置引用数据查询SQL节点为上游节点。
单击调度配置,在
根据节点名称单击添加,将上面创建的数据查询SQL节点添加为数据推送节点的上游节点。在
选择创建的Serverless资源组。在
单击添加参数,将数据查询SQL节点的输出参数作为取值来源添加为数据推送节点的输入参数。
配置推送目标及内容
在数据推送节点编辑页面中,自定义推送标题,并配置推送目标及正文内容。
配置推送目标
在数据推送目标选择目标源。
若目标源不存在,可单击创建数据推送目标。也可在数据服务中设置数据推送目标。
说明如需修改数据推送目标,仅支持在数据服务的数据推送中进行相应修改。
进入新建推送目标页面,根据以下信息创建数据推送目标。
新建钉钉、飞书、企业微信及Teams推送目标
参数
配置说明
数据推送目标
选择钉钉、飞书、企业微信或Teams。
目标名称
可根据业务需求进行自定义。
Webhook
根据所选的数据推送目标,获取并配置对应的Webhook信息。
钉钉机器人Webhook获取方式可参见:常见问题中的如何获取企业内部应用机器人Webhook的access_token。
飞书机器人Webhook获取方式可参见:飞书Webhook触发器配置。
企业微信机器人Webhook获取方式可参见:群机器人配置说明。
Teams Webhook获取方式可参见:使用Microsoft Teams工作流创建传入Webhook。
新建邮箱推送目标
参数
配置说明
数据推送目标
选择邮件。
SMTP Host
SMTP服务器的地址,用于发送邮件。
SMTP Port
SMTP服务器的端口号,用于连接邮件服务器。默认为465,可手动修改。
发信地址
邮件发送地址。
发信昵称
非必填,自定义发信人昵称。
SMTP账号
用于登录SMTP服务器的邮箱账号。
SMTP密码
用于验证SMTP账号身份的密码。
接收地址
邮件接收方的邮箱地址,多个地址可用逗号分隔。
配置推送正文
可通过Markdown、表格、邮件正文三种方式配置正文信息。
数据推送正文中的Markdown可以直接使用数据推送节点的节点输入参数的参数名作为占位符
${节点输入参数名}
,获取上游输出的参数。数据推送正文中的表格,可通过上游数据查询SQL节点的字段名作为关联参数获取数据。
DataWorks数据推送中,支持在推送内容中添加邮件正文,编辑邮件正文内容时,需注意以下事项:
每个数据推送任务仅支持添加一个邮件正文。
邮件正文仅在推送目标为邮件时进行渲染此正文内容,推送目标非邮件时,邮件正文将会在Webhook推送的消息中被隐藏。
调试运行数据推送
配置完成后,保存数据查询SQL节点和数据推送节点后,您可单击工作流上方工具栏中的图标,调试运行数据推送任务。