最新历史版本 :6.1 兼容说明 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

FineBI 对产品进行了持续优化升级,2024 年 6.0 版本全新来袭。

本文将为你说明从 6.0 到 6.1.3 有哪些升级兼容说明。

注: 6.1.3 为 6.1 最早的稳定发布版本。

2. 产品升级编辑

2.1 新功能速览

升级前了解一下新版本功能:6.1.0 更新日志6.1.1 更新日志6.1.3 更新日志

2.2 迁移容器化

FineBI 6.1 工程需要迁移容器化,迁移容器化的兼容说明见:迁移前兼容须知

2.3 lic文件更新

升级上来的用户需要更换 FineBI 6.1 的 lic 文件。

3. 引擎架构升级编辑

FineBI6.1 计算和存储分离,让 FineBI 的稳定性、扩展性、性能大幅提升。

1715567946751428 (1).png

FineBI6.1 架构如下图所示:

1718267733429373 (1).png

3.1 内存回收逻辑优化

FineBI 应用节点和引擎元数据节点删除了半小时一次 full gc 逻辑。版本升级后的客户可能出现监控面板内存常驻上升,只要触发 fgc 后能内存正常被释放则无需关注;

2024-12-03_13-54-10.png

3.2 引擎升级对计算结果的影响

新旧抽取引擎对空值的计算差异。详情请参见:6.1对比6.0的空值计算差异

4. 分析主题编辑

4.1 一站式分析新路径

分析主题修改后不再自动保存。

业务人员或分析师,在进行数据分析的过程中,一定会遇到需要调整数据的情况。

  • FineBI 6.0: 数据经过编辑后需要保存,更新后要等待更新,才能使用新字段。如果更新时间长,分析思路会被打断,分析的效率也会大大降低。

  • FineBI 6.1: 提供主题级别的分析体验。主题内数据编辑到可视化分析无需等待,结束后「保存」并「更新」主题即可。

1715312621109711 (1).png


解决方案:需要设计开发用户适应新版本的分析路径,老用户快速适应 6.1 版本的分析路径教学视频:FineBI v6.1 分析主题

4.2 仪表板新增笛卡尔积膨胀检测

不兼容说明:6.1 新加的稳定性参数限制,如限制了膨胀了 5 倍&笛卡尔积的场景,涉及场景包括主题模型关联,def函数嵌套等业务分析场景。
解决方案:减少仪表板分析时所使用的数据量,将相关计算前置到自助数据集中抽取落地;或避免产生笛卡尔积。
影响的功能包括但不限于:6.0 版本中仪表板可正常预览,升级后无法预览,报错超过 N:N 膨胀系数。报错提示:JOIN_N_TO_N_ERROR_CODE_61300430: N2N Expansion restriction 。如下图所示:

企业微信截图_17331968941091.png

4.3 仪表板重置按钮功能变化

产品逻辑变更:仪表板中“重置”按钮不再清空所有过滤条件,而是重置成模板原始保存状态,使得更符合“重置”的定义。

若要实现清空所有过滤条件的功能,需新增“清空”按钮。详见帮助文档说明:查询重置组件
解决方案:根据实际场景判断,若仍要保持"清空所有过滤条件"的效果,则需手动修改为"清空”按钮。否则无需调整。

1719564757U4nJ.png

4.4 公式复杂度限制优化

出于宕机稳定性考虑,将抽取公式的默认复杂度限制由 10000 改成 5000 。

5. 数据编辑

5.1 抽取数据需更新

5.1及6.0版本的抽取数据在 6.1 中无法使用。

解决方案:升级到 6.1 后,所有抽取数据集全部重新从数据库抽取更新。

2024-12-03_15-04-10.png

5.2 Doris 数据库兼容问题

使用 MySQL数据连接 类型连接 Doris 数据库,不兼容 year() 函数。
解决方案:把原 MySQL数据连接重命名,再重新添加一个正确的同名 Doris数据连接,确认数据可以正常的读取,场景正常后,删除掉原数据连接。

如原本 MySQL数据连接名称为「Doris」,则重命名为「Dorisbak」;然后使用 Doris数据连接添加一个名称为「Doris」的数据连接,以此确保数据集无需逐一修改。

6. 平台编辑

6.1 数据查看权限范围优化

由于 6.1 权限进行了更严格的管控,只有表的组件数据权限时无法查看表的明细数据,故升级后可能会出现编辑表显示计算结果为空的场景。

解决方案:给用户分配表的使用权限。

2024-12-03_15-09-10.png

6.2 服务器数据集更新

服务器数据集变动 ,各数据集字段说明详见: BI系统配置数据集

新增:组件基础信息表,分析文档基础信息表、主题内资源血缘表

删除:仪表板所用数据集,组件所用数据集表。

          解决方案:使用「主题内资源血缘表」重新开发

变动:主题信息表(新增是否开启链接)、目录挂出信息表(仪表板ID-资源挂出id,增加资源类型、主题id字段)。

          解决方案:需要编辑基础表重新勾选字段,否则会出现表更新失败问题

6.3 数据门户不兼容

数据门户插件暂不兼容,在 6.1.4 版本适配。

6.4 应用封装不兼容

应用封装插件暂不兼容,在 6.1.4 版本适配。

6.5 仪表板ID接口变化

6.1版本中接口/10/view/entry/tree返回的 templateId 不再表示 BI模板ID。

解决方案:若使用到此接口,则联系帆软升级技术支持获取。

技术支持联系方式:服务平台>在线支持

6.6 驱动隔离功能变化

驱动隔离不再支持,改用「驱动管理」,并修改对应的数据连接配置为驱动路径「自定义」。

详情请参见文档:驱动管理

1666248794CuoP.png

6.7  BI RestAPI 数据集插件不兼容

BI RestAPI 数据集插件 插件暂不兼容,预计在 2025 年的 6.1.5 版本适配。