历史版本21 :管理更新任务 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 应用场景

使用抽取数据则需要进行 数据更新 以保证数据的可用性。这时候我们需要对使用「更新任务管理」来进行管理和监控:

  • 查看正在更新的任务和已经更新完成的任务,监控具体的更新信息和报错信息;

  • 在一个统一的页面对分散设置的定时更新任务进行查看和管理;

  • 对于正在进行的更新任务,所有用户可以查看它的更新进度;

  • 有管理权限的用户可以手动停止正在执行的更新任务;

  • 超级管理员可以让更新任务插队;

1.2 功能简介

FineBI 提供了监控更新情况、停止更新任务和设置定时更新的功能。

2. 查看更新情况(运行监控)编辑

选择「公共数据>更新任务管理」,如下图所示:

4.png

2.1 查看更新任务

进入数据更新「运行监控」界面,可以看到已经结束或者正在更新的任务,如下图所示:

5.png

拥有数据权限不同的用户,可以看到的更新任务是不同的,与他们所拥有的数据权限相关,详情请参见: 数据权限 2.3节

  • 正在更新的任务(更新状态显示为进度条),可以被所有用户看到,可以被有「管理权限」的用户看到并查看详情。

  • 所有已结束的任务(更新状态显示为已结束),可以被所有有「管理权限」的用户看到并查看详情。

展示更新内容如下所示:

显示内容
说明

任务名称

  • 「单表更新」默认为:表名+单表更新

  • 「文件夹更新」默认为:文件夹名+文件夹更新任务

  • 「全局更新」默认为:全局更新任务

  • 「关联更新」默认为:关联更新

注:任务名称可重复。

任务开始时间、任务结束时间
更新开始和结束的时间
更新状态

有四种状态:

已结束、正在更新中显示为进度条、排队等待、停止更新(即当任务被手动停止)

进度条进度为 更新成功的表数目/共需更新的表数目

触发方式手动、定时
触发人其中设定为 定时更新 任务触发角色为 system
基础表更新
更新成功的数目 / 共需更新数目
自助数据集更新更新成功的数目 / 共需更新数目
关联更新更新成功的数目 / 共需更新数目

2.2 搜索更新任务

注:搜索框中更新状态默认全选。

点击下拉,用户可通过如下筛选条件筛选:更新任务名称、任务开始时间、任务结束时间、触发方式、触发人、更新状态、运行结果。点击「搜索」,如下图所示:

6.png

2.3 查看任务详情

点击「详情 」,如下图所示:

1.png

展示「全部报错信息」以及 基础表、自助数据集、基础表关联信息、权限继承关联信息、其他关联信息的更新状况,如下图所示:

7.png

2.3.1 查看更新报错提示

若更新状态为失败,点击「更新失败」按钮,可显示更新失败的原因;

9.png

更新报错原因提示如下所示:

报错类型
报错原因提示
数据集生成错误数据集字段可用性出现问题,问题字段已经标记为红色,建议重新编辑本数据集后再次更新。被依赖的数据集发生更改有可能会引发该错误
无法正确获取数据,请检查该数据集的配置或数据库配置是否正常
数据集的父表 [X] 由于异常更新失败,故该数据集无法正常更新
增量更新相关语句均为空,请检查该数据集的增量更新配置情况
注:若没有填写增量更新语句,不允许进行更新
该基础表已经进行过行列转换或者自循环列操作,无法进行增量更新,请全量更新该基础表
服务器数据集无法执行增量更新,请配置为全量更新,并取消增量更新配置
数据库连接失败我们无法连接到包含该数据集的数据连接,请检查数据连接可用性
关联生成错误关联生成错误 - 文件夹名/表名[字段名] 与 文件夹名/表名[字段名] 的关联生成失败,关联字段[字段名]数据重复

点击报错的表名,可出现弹窗:

  • 点击「查看该表数据」,可以直接跳转到该表所在位置。

  • 点击「查看该表影响的自助数据集」:可在下方直接查看此表更新失败影响到的自助数据集。如下图所示:

18.png

3. 停止更新编辑

3.1 手动停止更新

只有有管理权限(详情请参见:数据权限 2.3节)的用户可以停止正在更新的任务。点击「详情」,如下图所示:

10.png

然后可以看到正在执行的进度条,点击「立即结束」,即可结束正在执行的任务。如下图所示:

11.png


设置停止更新时数据表状态提示可使用的数据
点击停止更新时已完成更新停止更新时已更新成功的表/关联无报错更新后的数据
停止更新时已更新失败的表/关联提示停止更新前具体失败的原因上次更新成功的数据
点击停止更新时未完成更新更新任务被中断,不再执行上次更新成功的数据

3.2 智能中断更新

在更新过程中,有可能会因为用户网络、环境不稳定而出现更新异常,导致更新卡住,无法成功更新。

 对于这种情况,FineBI 为用户提供了「智能中断」功能,当某个基础表更新异常时, FineBI 会自动杀掉该基础表的更新,并且不影响同一个更新任务中的其他基础表更新。

  • 智能中断更新功能是针对基础表更新的功能,判断基础表是否更新异常;

  • 基础表最长更新时间为 12 小时,若 12 小时后某张基础表还没更新完成,则会强制终止该基础表的更新;

  • 智能中断会检测是否有误中断,不会误伤更新正常的基础表。

若用户不需要 FineBI 智能中断更新任务,可将 SystemOptimizationConfig.openUpdateIntelligentKill 的参数值改为 false,更改参数的操作方法详情请参见:FINE_CONF_ENTITY可视化配置

4. 更新任务插队编辑

超级管理员可以让正在排队等待的任务插队更新。

如下图「销售DEMO文件夹更新任务」正在排队等待中,如想要该任务插队提前更新,可以点击「详情」。如下图所示:

12.png

点击「插队>确定」,如下图所示:

13.png

以下情况会导致无法插队:

  • 当正在插队的任务数量大于限制时(默认限制 5 个),插队会失败。用户可以通过更改

    SystemOptimizationConfig.maxCutInLineCount 的参数值来修改限制数量,更改参数的操作方法详情请参见:FINE_CONF_ENTITY可视化配置

  • 与要插队的任务与正在更新的任务有冲突时,插队会失败;

  • 正在更新的任务,详情页里无「插队」按钮。

5. 管理定时更新任务编辑

5.1 定时更新任务

「更新任务管理」页面下方,是「BI数据定时更新任务」。如下图所示:

一个用户,可以查看并管理他有管理权限(详情请参见:数据权限 2.3节)的任务。

15.png

5.2 搜索定时更新任务

点击下拉,输入需要搜索的「更新任务名称、运行时间、更新类型、运行状态」等信息,点击「搜索」,如下图所示:

16.png

界面显示对应搜索条件的搜索结果。

5.3 管理定时更新

可在此界面设置和调整更新任务,如下所示:

图标作用
1597719588555419.png1597719646209845.png启用、暂停该定时更新任务

忽略配置的更新任务触发时间,立即执行一次该定时更新任务

注:若没有填写增量更新语句,不允许立即执行增量更新

1597719678519719.png修改任务。进入一个与添加任务一样的页面的第一步,其中所有填充项均为之前配置的各项任务参数。最终保存才生效
1597719705669097.png删除该定时更新任务
结果通知详情参见:定时更新 2.2节

5.3.1 编辑定时更新

点击1597719678519719.png,可以编辑修改已有的定时更新任务,如下图所示:

17.png

此处定时更新不支持设置的内容:

定时更新不支持设置内容
文件夹是否跟随全局更新而更新

单表在文件夹

更新时如何跟随更新

增量增加语句
增量删除语句

6. 注意事项编辑

  • 更新信息存储详情参见:平台日志

  • 修改 SQL 数据集的 SQL 语句后,不能直接进行增量更新,必须先执行一次全量更新,才能进行增量更新。

  • 新添加的 DB 表、SQL 数据集,不能直接进行增量更新,必须先执行一次全量更新,才能进行增量更新。