You need to enable JavaScript to run this app.
导航

LAS 报表任务

最近更新时间2024.04.17 16:20:35

首次发布时间2022.08.31 16:28:03

1 概述

通过报表任务,结合湖仓一体分析服务(LAS),您可以实现将 LAS SQL 查询的数据结果,以报表形式,通过邮件发送给当前主账号下的用户。您可以自定义邮件标题、正文、头尾展示等内容,同时支持附件的发送。本文将为您介绍报表任务的使用方式。

2 使用前提

  1. DataLeap产品若仅开通 Dataleap大数据集成 服务,不支持创建 LAS 报表任务。
  2. 收件人需先在访问控制界面,用户个人信息中配置邮箱信息,操作详见:访问控制
  3. 查询的全量数据以附件形式提供,若附件大小超过 10M,则邮件中不带附件。
  4. 消息中心对消息发送的频控和内容去重有以下限制:
    • 若相同的邮箱地址,且发送的内容(邮件标题+正文内容+附件内容)完全一致时,12小时内,仅能收到1个邮件消息;
    • 同一个邮箱地址,不同发送内容时,每分钟最多能发送20封邮件消息、每小时最多能发送25封邮件消息、每天最多能发送30封邮件消息;

3 任务配置

3.1 新建任务

  1. 登录 DataLeap租户控制台
  2. 概览界面,显示加入的项目中,单击数据开发进入对应项目。
  3. 任务开发界面,左侧导航栏中,单击新建任务按钮,进入新建任务页面。
  4. 选择任务类型:
    1. 分类:数据开发。
    2. 绑定引擎:LAS
    3. 选择任务:离线数据 LAS 报表任务
  5. 填写任务基本信息:
    1. 任务名称:输入任务的名称,只允许字符.、字母、数字、下划线、连字符、[]、【】、()、()以及中文字符,且在127个字符以内。
    2. 保存至: 选择任务存放的目标文件夹目录。
  6. 单击确认按钮,成功创建任务。

图片

3.2 任务配置

3.2.1 基础信息配置

参数

说明

报表类型

目前仅支持Email形式。

收件人

输入当前主账号下的用户信息,会将邮件信息发送给选定用户的邮箱,支持设置多个用户接收。

邮件标题

默认以【Dataleap】+自定义邮件标题。

邮件正文

输入邮件正文信息,例如:这是一封由Dataleap 报表任务发出的商品信息接收测试邮件。

邮件正文头尾展示

您可以选择正文头、正文尾的信息是否展现:

  • 邮件正文头:该任务的链接
  • 邮件正文尾:任务从哪里发送(火山引擎-DataLeap)

3.2.2 报表任务配置

  1. 报表名称:输入报表名称信息、以及描述信息,方便后续管理。

  2. 勾选查询的报表数据,是否在邮件正文中显示(正文中最多显示1000条数据),全量数据可通过附件中的 Excel 表格下载来查看。

  3. 复制报表:您可通过右侧的按钮,来快捷复制一份相同的报表内容,您也可以在复制的报表上做二次修改操作。

  4. 编辑 LAS SQL 查询报表的逻辑语句,语句中的变量前后需要加双引号,示例如下:

    select col1,col2 from db.table where date="${date}" limit 10;
    
  5. SQL编辑完成后,您可以在编辑器上方的功能栏中,将语句格式化,或者解析语句是否正确等操作,执行引擎仅支持 Spark 引擎。

  6. 列名配置:邮件报表中的字段列名展现设置

    • 自动添加:您可以根据 SQL 代码内容,来自动添加 SQL 中的字段信息,以及对应邮件中的表列名信息。
    • 手动添加:您可以手动添加列名信息在邮件的表格中展现,SQL查询的字段数量需要和列名配置中的数量一致。
    • 全部删除:添加的列名配置,支持全量删除操作。
    • 单字段移动删除:您可以在字段列表右侧,手动拖动当前字段列的顺序,或者删除当前字段。
      图片
  7. 调度配置:在右侧导航栏中,进入调度配置界面,配置 LAS 队列信息、调度属性相关配置。详见:调度配置

3.3 调试任务

任务基础信息和报表信息配置完成后,您可单击任务上方的调试按钮,进行报表发送调试。

注意

  • 调试操作,直接使用线上数据进行调试,需谨慎操作。
  • 报表任务调试阶段,仅支持发送邮件给调试发起人,因此调试发起人,需要在个人信息中配置好邮箱信息。
  • 本任务类型支持调试执行成功或失败后发送消息通知,您可根据业务情况,前往项目控制台 > 配置信息 > 消息通知设置中,选择是否开启任务调试运行成功失败通知。
    • 默认通知方式为邮箱,您需在“账号管理”中,提前绑定相应的安全邮箱信息;
    • 您也可根据业务需要,自行配置飞书应用机器人,通过飞书的方式发送消息通知,飞书消息通知前置操作详见1.1 飞书应用机器人创建

调试成功后,可展开页面下方的查询控制台,查看调试记录、运行状态和调试日志等信息。

4 提交任务

任务所需参数配置和调试任务成功后,将任务提交发布到运维中心离线任务运维中执行。
单击上方操作栏中的保存提交上线按钮,在提交上线对话框中,选择回溯数据、监控设置、提交设置等参数,最后单击确认按钮,完成作业提交。 提交上线说明详见:数据开发概述---离线任务提交
后续任务运维操作详见:离线任务运维