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