1. 概述
1.1 版本
| FineBI 版本 | 功能变动 |
|---|---|
| 7.0 | - |
| 7.0.4 |
|
1.1 应用场景
使用抽取数据则需要进行 数据更新 以保证数据的可用性。这时候我们需要对使用「更新任务管理」来进行管理和监控：
查看正在更新的任务和已经更新完成的任务，监控具体的更新信息和报错信息；
在一个统一的页面对分散设置的定时更新任务进行查看和管理；
有管理权限的用户可以手动停止正在执行的更新任务；
超级管理员可以让更新任务插队；
1.2 功能简介
FineBI 提供了监控更新情况、停止更新任务和设置定时更新的功能。
2. 查看当前运行情况
1）选择「数据目录>更新任务管理」，如下图所示：
2）进入第一个 Tab 页「当前运行情况」。用户可以查看到当前正在更新的所有任务，且可以通过右上角搜索框搜索正在更新的任务。
而超级管理员可以查看汇总提示信息，了解正在更新、排队、插队的任务共有多少。
筛选任务时间的时候，可以细化到「时分秒」；也可以筛选「动态时间」，如下图所示：
3）鼠标悬浮在「任务进度」，用户可查看当前任务的更新进度。
任务正在更新，提示会显示当前的更新进度：已结束的表或关联的个数：x / 总数：y；
若任务正在排队，提示会显示当前任务排队的原因；
2.1 更新任务插队
当有更新任务正在执行时，后面开启的更新任务就需要排队等待。若我们希望正在排队的任务可以插队到前面更新时，可以使用插队功能。
注意点：该功能仅支持超级管理员使用。
当正在插队的任务数量大于限制时（默认限制 5 个），插队会失败。用户可以通过更改
SystemOptimizationConfig.maxCutInLineCount 的参数值来修改限制数量，更改参数的操作方法详情请参见：FINE_CONF_ENTITY可视化配置
2.2 停止更新任务
2.2.1 手动停止更新
可以手动停止正在更新的任务：批量停止、单个任务停止；
注意点：该功能仅支持有数据管理权限（详情请参见：数据权限 2.3节）的用户使用。
| 设置停止更新时数据表状态 | 提示 | 可使用的数据 | |
|---|---|---|---|
| 点击停止更新时已完成更新 | 停止更新时已更新成功的表/关联 | 无报错 | 更新后的数据 |
| 停止更新时已更新失败的表/关联 | 提示停止更新前具体失败的原因 | 上次更新成功的数据 | |
| 点击停止更新时未完成更新 | 更新任务被中断，不再执行 | 上次更新成功的数据 | |
2.2.2 智能中断更新
在更新过程中，有可能会因为用户网络、环境不稳定而出现更新异常，导致更新卡住，无法成功更新。
对于这种情况，FineBI 为用户提供了「智能中断」功能，当某个基础表更新异常时， FineBI 会自动杀掉该基础表的更新，并且不影响同一个更新任务中的其他基础表更新。
智能中断更新功能是针对基础表更新的功能，判断基础表是否更新异常。
基础表最长更新时间为 12 小时，若 12 小时后某张基础表还没更新完成，则会强制终止该基础表的更新。
本次中断更新不影响下一次定时更新任务，此期间用户也可手动进行单表更新。
智能中断会检测是否有误中断，不会误伤更新正常的基础表。
若用户不需要 FineBI 智能中断更新任务，可将 SystemOptimizationConfig.openUpdateIntelligentKill 的参数值改为 false，更改参数的操作方法详情请参见：FINE_CONF_ENTITY可视化配置
2.3 查看更新详情
点击「详情」即可查看更多更新信息。如下图所示：
注意点：该功能仅支持有数据管理权限（详情请参见：数据权限 2.3节）的用户使用。
在详情界面中，也可以结束任务和插队任务，插队只有超级管理员可以操作。
详情界面中也罗列了更具体的更新信息，例如点击展开「基础表」，可以看到具体某个表的更新状况，如下图所示：
A：点击直接跳转查看该报错表的具体数据；
B：点击即可在下方查看该表报错影响的自助数据集；
C：点击查看具体的报错信息；
3. 历史运行情况
点击「历史运行情况」，可查看历史更新任务。如下图所示：
注意点：该功能仅显示有数据管理权限（详情请参见：数据权限 2.3节）的更新任务。
点击「详情」，可以查看此任务中的报错信息，以及基础表、自助数据集、关联等此次更新的详细信息。如下图所示：
点击「表名」可查看该表数据以及该表影响的自助数据集
点击「更新状态」中「更新失败」可查看失败原因
点击「更新所花时间」可查看「更新耗时明细」
| 更新耗时明细 | 说明 |
|---|---|
| 排队耗时 | 从表触发更新开始，到表开始更新的时间差 |
jdbc取数耗时 | 更新时，该数据集的jdbc取数耗时 |
| 引擎耗时 | 更新时，该数据集的引擎耗时 |
更新任务数据说明
更新的基础表：121/235
121：更新成功+不抽取的数据集
235：总数据集
不抽取的数据集：44/62
44：更新前后都是不抽取的数据集（有些由于其他导致此次报错的不统计其中）
62：更新前不抽取的数据集总数
4. 数据集运行记录
点击「数据集运行记录」，用户可以看到单张表的运行情况。系统为您提供「平均每日更新次数」、「平均更新时长」、「历史失败率」等字段。
通过查看这些信息，您可以对失败率高的数据集进行排查，并对高频次更新的表做出更合理安排。如下图所示：
点击「表名」跳转到数据集所在位置查看详情
点击「上次更新耗时」查看「更新耗时明细」
不活跃的数据集，显示为「暂不抽取」，详细请参见：自助数据集单表更新 第 4 节；
5. 定时任务管理
定时任务管理界面可以辅助用户更好的管理定时更新任务：
通过查看界面上方图表，可帮助用户了解任务时间的分布，若时间分布过于集中，用户可适当进行调整。
通过界面下方的表格，用户可对自己有权限的所有定时更新任务进行删除、开启/关闭比、编辑等操作。
注意点：该功能仅显示用户有数据管理权限（详情请参见：数据权限 2.3节）的定时更新任务。
点击编辑按钮，用户可对定时任务的「任务名称、开始时间、执行频率、结束时间、结果通知」这些信息进行更改，详情参见：定时更新，如下图所示：
6. 注意事项
更新信息存储详情参见：平台日志
修改 SQL 数据集的 SQL 语句后，不能直接进行增量更新，必须先执行一次全量更新，才能进行增量更新。
新添加的 DB 表、SQL 数据集，不能直接进行增量更新，必须先执行一次全量更新，才能进行增量更新。
上一篇：Cron表达式示例
