1. 概述
1.1 版本
| FineBI 版本 | JAR 包版本 | 功能变动 |
|---|---|---|
| 5.1.5 | 2020-09-02 | |
| 5.1.6 | 2020-09-30 |
|
| 5.1.12 | 2021-04-27 |
|
| 5.1.15 | - | 新增智能查杀功能，自动中断更新异常的更新任务 |
1.2 应用场景
使用抽取数据则需要进行 数据更新 以保证数据的可用性。
查看正在更新的任务和已经更新完成的任务，并看到这些任务具体的更新信息和报错信息。
在一个统一的页面对分散设置的定时更新任务进行查看和管理。
对于正在进行的更新任务，所有用户可以看到它的更新进度，有管理权限的用户可以在不需要的时候停止该更新任务。
1.3 功能简介
FineBI 提供了监控更新情况、停止更新任务和设置定时更新的功能。
2. 查看更新情况（运行监控）
登录 FineBI ，选择数据准备>更新任务管理，如下图所示：
2.1 查看更新任务
进入数据更新「运行监控」界面，可以看到已经结束或者正在更新的任务，如下图所示：
拥有数据权限不同的用户，可以看到的更新任务是不同的，与他们所拥有的数据权限相关，详情请参见: 数据权限 2.3节
正在更新的任务（更新状态显示为进度条），可以被所有用户看到，可以被有「管理权限」的用户看到并查看详情。
所有已结束的任务（更新状态显示为已结束），可以被所有有「管理权限」的用户看到并查看详情。
展示更新内容如下所示：
| 显示内容 | 说明 |
|---|---|
任务名称 |
注：任务名称可重复。 |
| 任务开始时间、任务结束时间 | 更新开始和结束的时间 |
| 更新状态 | 已结束、正在更新中显示为进度条 |
| 触发方式 | 手动、定时 |
| 触发人 | 其中设定为 定时更新 任务触发角色为 system |
| 基础表更新 | 更新成功的数目 / 共需更新数目 |
| 自助数据集更新 | 更新成功的数目 / 共需更新数目 |
| 关联更新 | 更新成功的数目 / 共需更新数目 |
2.2 搜索更新任务
注：搜索框中更新状态默认全选。
点击下拉，输入需要搜索的「更新任务名称、任务时间、触发方式、触发人、更新状态、运行结果」等信息，点击「搜索」，如下图所示：
2.3 查看任务详情
点击「详情 」，如下图所示：
展示「更新报错信息、基础表更新情况、自助数据集更新情况、关联信息更新情况」，如下图所示：
2.3.1 查看更新报错原因
若更新状态为失败，点击「更新失败」按钮，可显示更新失败的原因，如下图所示：
更新报错原因提示如下所示：
| 报错类型 | 报错原因提示 |
|---|---|
| 数据集生成错误 | 数据集字段可用性出现问题，问题字段已经标记为红色，建议重新编辑本数据集后再次更新。被依赖的数据集发生更改有可能会引发该错误 |
| 无法正确获取数据，请检查该数据集的配置或数据库配置是否正常 | |
| 数据集的父表 [X] 由于异常更新失败，故该数据集无法正常更新 | |
| 增量更新相关语句均为空，请检查该数据集的增量更新配置情况 注：若没有填写增量更新语句，不允许进行更新 | |
| 该基础表已经进行过行列转换或者自循环列操作，无法进行增量更新，请全量更新该基础表 | |
| 服务器数据集无法执行增量更新，请配置为全量更新，并取消增量更新配置 | |
| 数据库连接失败 | 我们无法连接到包含该数据集的数据连接，请检查数据连接可用性 |
| 关联生成错误 | 关联生成错误 - 业务包名/表名[字段名] 与 业务包名/表名[字段名] 的关联生成失败，关联字段[字段名]数据重复 |
2.3.2 定位更新失败的数据表
对于更新失败的数据表，除了可以查看报错原因，还可以查看表的存放位置。
若更新失败的表为基础表，还可以查看该表影响的自助数据集。
数据表更新失败，则会标红，点击更新失败的「合同回款事实表」（此处以基础表为例），选择「查看该表数据」，会跳转到该数据表所在的业务包下，如下图所示：
点击「合同回款事实表」，选择「查看该表影响的自助数据集」，自助数据集更新任务详情会跳转到「合同回款事实表」更新失败影响的自助数据集，如下图所示：
点击返回，则回到显示所有自助数据集的更新情况，如下图所示：
3. 停止更新
3.1 手动停止更新
只有有管理权限（详情请参见：数据权限 2.3节）的用户可以停止正在更新的任务。点击「详情」，如下图所示：
| 设置停止更新时数据表状态 | 提示 | 可使用的数据 | |
|---|---|---|---|
| 点击停止更新时已完成更新 | 停止更新时已更新成功的表/关联 | 无报错 | 更新后的数据 |
| 停止更新时已更新失败的表/关联 | 提示停止更新前具体失败的原因 | 上次更新成功的数据 | |
| 点击停止更新时未完成更新 | 更新任务被中断，不再执行 | 上次更新成功的数据 | |
3.2 智能中断更新
在更新过程中，有可能会因为用户网络、环境不稳定而出现更新异常，导致更新卡住，无法成功更新。
对于这种情况，FineBI 为用户提供了「智能中断」功能，当某个基础表更新异常时， FineBI 会自动杀掉该基础表的更新，并且不影响同一个更新任务中的其他基础表更新。
智能中断更新功能是针对基础表更新的功能，判断基础表是否更新异常；
基础表最长更新时间为 12 小时，若 12 小时后某张基础表还没更新完成，则会强制终止该基础表的更新；
智能中断会检测是否有误中断，不会误伤更新正常的基础表。
若用户不需要 FineBI 智能中断更新任务，可将 SystemOptimizationConfig.openUpdateIntelligentKill 的参数值改为 false，更改参数的操作方法详情请参见：FINE_CONF_ENTITY可视化配置
4. 管理定时更新任务
4.1 定时更新任务
「更新任务管理」页面下方，是「BI数据定时更新任务」。如下图所示：
一个用户，可以查看并管理他有管理权限（详情请参见：数据权限 2.3节）的任务。
4.2 搜索定时更新任务
点击下拉，输入需要搜索的「更新任务名称、运行时间、更新类型、运行状态」等信息，点击「搜索」，如下图所示：
界面显示对应搜索条件的搜索结果。
4.3 管理定时更新
可在此界面设置和调整更新任务，如下所示：
| 图标 | 作用 |
|---|---|
| 、 | 启用、暂停该定时更新任务 |
| 忽略配置的更新任务触发时间，立即执行一次该定时更新任务 注：若没有填写增量更新语句，不允许立即执行增量更新 |
| 修改任务。进入一个与添加任务一样的页面的第一步，其中所有填充项均为之前配置的各项任务参数。最终保存才生效 |
| 删除该定时更新任务 |
| 结果通知 | 详情参见：定时更新 2.2节 |
4.3.1 编辑定时更新
注：可编辑的定时更新任务必须是已经在「数据准备>业务包/数据表>更新信息」下添加过后的。
点击，调整定时更新设置信息，设置定时更新「触发时间」、「执行频率」、「结束时间」以及「通知结果」，点击「确定」，详情参见：定时更新，如下图所示：
注：「单表定时更新」可设置全量更新或者增量更新。
此处定时更新不支持设置的内容：
| 定时更新不支持设置内容 |
|---|
| 业务包是否跟随全局更新而更新 |
| 单表在业务包更新时如何跟随更新 |
| 增量增加语句 |
| 增量删除语句 |
5. 注意事项
更新信息存储详情参见：平台日志
修改 SQL 数据集的 SQL 语句后，不能直接进行增量更新，必须先执行一次全量更新，才能进行增量更新。
新添加的 DB 表、SQL 数据集，不能直接进行增量更新，必须先执行一次全量更新，才能进行增量更新。
