定时任务界面介绍

1.1 版本

1.2 功能简介

本文对「数据开发」下的「定时任务」模块的界面进行详细描述和解释，以帮助用户更好地了解该模块的功能和使用方法。

任务列表中用户可查看和编辑所有有 权限 的定时任务。

2.1 定时任务

鼠标点击某个定时任务右侧的标志，可修改任务名称与描述、将任务移动到某个路径下、将任务复制到某个路径下、删除任务、导出任务。如下图所示：

说明如下：

1）复制的任务的节点/算子配置、参数设置、调度配置中的超时限制、失败重试、结果通知、画布布局都支持保留，但定时任务的「开启调度」不保留。

2）4.1.6.5 及之后版本，支持拖拽定时任务来改变其位置：

• 所有用户均可手动拖拽有权限的定时任务。

• 拖拽结果对所有用户生效。

• 升级到 4.1.6.5 及之后版本后，目录树均初始化为「按名称排序」的结果。

• 某用户从上到下看到的定时任务为 5、1、7；管理员从上到下看到的定时任务为 5、6、1、9、7；该用户将 7 挪到 5 和 1 之间，管理员侧将看到 7 在 1 上面，在 6 下面；即被挪动的任务紧靠下方的那个目标节点（目标节点为 5 和 1,1为靠下的位置）。

3）「移动到」按钮说明：该按钮不支持改变位次，只能改变所在文件夹；不支持移动到所在文件夹（文件夹 A 中的任务不能移动到文件夹 A）；在文件夹 A 中的定时任务，点击「移动到」按钮，移动到文件夹 B ，定时任务移动后，将位于文件夹 B 的末尾；「移动到」效果对所有用户生效。

4）4.1.6.5 及之后版本，「重命名」按钮被替换为「名称与描述按钮」；点击「名称与描述按钮」，可修改定时任务的名称与描述。如下图所示：

注1：任务名称最多 60 个字符，任务描述最多 300 个字符。

注2：若升级前任务名称已超过 60 字符，升级后，保留任务名称，修改任务名称时，限制 60 字符。

添加描述后，鼠标悬浮在定时任务上，可显示定时任务的名称与描述。如下图所示：

若某定时任务没有添加描述，鼠标悬浮在定时任务上，只显示任务名称。

5）新建定时任务时，可设置定时任务的位置、名称、描述。如下图所示：

注：任务名称最多 60 个字符，任务描述最多 300 个字符。

2.2 文件夹

鼠标点击某个文件夹右侧的标志，可对该文件夹做重命名、移动到某个路径下、删除操作。如下图所示：

4.1.6.5 及之后版本，文件夹支持拖拽来挪动其顺序，具体说明可参见本文 2.1 节的定时任务拖拽说明。

3.1 节点拖拽

可以直接从节点列表拖拽节点到任务设计区域使用。如下图所示：

3.2 节点连线

1）按住鼠标从上游节点右侧输出点将光标挪到下游节点的左侧输入点，即可完成两个节点之间的连线。

可以选择连线的样式：在任务设计区域中可以选择使用「正交线」或者「曲线」，如下图所示：

2）新建连线支持直接生成节点。如下图所示：

3）支持调整连线的来源点和去向点。

例如调整去向点：鼠标移到去向箭头位置，箭头变成（此时连线高亮）时，可更换连线去向。

4）勾选「连线吸附」，节点添加到两个节点之间时，连线支持自动吸附。如下图所示：

3.3 节点布局与步骤撤销还原

在画布工具栏点击「自动布局」按钮，可以对画布内全部内容进行自动布局，使得节点布局更加美观，如下图所示：

同时，在画布中设置的节点步骤可以进行撤销还原操作，例如上一步中将节点任务执行条件改为「失败时执行」，那么撤销该步骤，则还原为成功时执行。如下图所示：

3.4 节点搜索

4.1.7.1 版本支持在编辑界面搜索：可对节点/算子进行搜索，并快速定位选中节点/算子，如下图所示：

• 每次打开定时任务，画布内容居中

• 拖拽画布时，不关闭节点面板

3.5 画布导航器

4.1.7.1 版本支持导航器功能，可显示画布内容的缩略图；支持拖拽移动视图；支持点击导航器其它区域，可快速定位画布内容，如下图所示：

对搜索和视图导航功能提供新手引导，如下图所示：

3.6 节点多选与复制

详情请参见：节点支持复制粘贴

3.7 节点支持禁用

支持禁用节点及下游节点。详情请参见：节点支持禁用

3.8 运行到此节点

在调试过程中，需要更新从上游到这个节点的数据（这个节点有下游节点），然后下个节点再进行调试。目前只能把后续节点禁用或者先断开连线，操作成本较高。

支持设置节点时，选择运行到此处，便于查看上游配置结果和调试。详情请参见：运行至此节点

3.9 移动设计界面画布

在设计界面按住键盘空格键，然后拖动鼠标光标，可以移动任务整体画布，操作如下图所示：

同时可以将任务无限拓展画布区域。如下图所示：

3.10 节点任务构建提示

4.0.18 版本支持在设计节点和任务时，实时提示节点和任务是否有错误，便于开发人员在构建前直观地看出任务能否构建成功以及影响构建的因素，并快速定位到问题，提升开发任务速度。

• 若设计任务时节点有异常，则会提示共有几个任务节点异常，同时鼠标悬浮在对应节点的异常警示图标时，出现悬浮框提示具体的异常问题，如下图所示：
  

• 若设计任务时节点无异常，则整个任务提示「无异常」，如下图所示：

3.11 左右拖拽任务Tab更换打开顺序

数据开发中，打开多个定时任务时，支持左右拖拽更换打开顺序。如下图所示：

3.12 支持查看节点运行状态

简介：

4.1.6.3 及之后版本，定时任务编辑界面中，新增「显示/隐藏节点状态」按钮，若开启「显示节点状态」按钮，画布内可显示节点运行状态；节点运行状态默认显示，用户若不需要可关闭。

应用场景：

• 定时任务运行后，可在任务编辑界面快速定位到出错节点。

• 定时任务运行后，可快速看到本次运行了哪些节点。

• 便于调试，调试节点后可快速查看运行结果。

如下图所示：

功能说明如下：

1）运行状态图标含义：

2）运行到当前节点时，连接线动态显示。如下图所示：

3）每次运行（任务运行/部分运行）都重置画布内的节点运行状态，与日志保持一致。

4.1 运行和终止任务

设计好的定时任务可以点击工具栏的「运行」来运行，如果需要中途强制终止任务，可以点击「终止」，操作如下图所示：

4.2 参数设置

工具栏中的「参数设置」可以让用户自定义一些参数，详细介绍参见文档：自定义参数

4.3 调度计划

详情请参见：调度计划

调度计划中，可为定时任务添加「定时调度」和「事件调度」。

• 定时调度：可为定时任务设置执行频率，定期自动运行定时任务，以保证数据能够及时更新，一个定时任务可设置多个执行频率。

• 事件调度：可设置任务的调度依赖。例如：数仓构建过程中 ODS 层有 a、b、c 任务互不影响、DW 层有 d 、f 任务，需要 a、b 任务执行完触发 d 任务，来减少 DW 层对 ODS 层完全更新完等待的时间；若 a、b 执行失败则不触发，来避免数据准确性的问题。

4.4 任务控制

定时任务的「任务控制」中，包含 3 个 Tab ，可为定时任务设置失败重试次数、超时时间、脏数据容忍行数、执行失败通知方式、任务优先级等。如下图所示：

详情请参见：任务控制概述

5.1 日志

任务日志展示区域的「日志」页可以查看当前任务的执行情况。

在「日志」这个 Tab 页下，具体显示内容请参见：运行日志介绍

5.2 统计

任务日志展示区域的「统计」页可以查看「数据同步」节点和「数据转换」节点的读写信息。

若定时任务运行过程中有脏数据，也展示脏数据信息；点击脏数据行数可展开查看各错误原因分类下的脏数据条数。

注1：表格中「总流量」字段代表读取和写入的数据量，所占用的流量。

注2：「统计」中，只统计包含输入、输出的节点，例如数据同步节点、数据转换节点等。