6.1 兼容说明

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

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

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

2.1 新功能速览

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

2.2 迁移容器化

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

2.3 lic文件更新

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

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

FineBI6.1 架构如下图所示：

3.1 内存回收逻辑优化

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

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

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

4.1 一站式分析新路径

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

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

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

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

解决方案：需要设计开发用户适应新版本的分析路径，老用户快速适应 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 。如下图所示：

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

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

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

4.4 公式复杂度限制优化

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

5.1 抽取数据需更新

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

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

5.2 Doris 数据库兼容问题

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

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

6.1 数据查看权限范围优化

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

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

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 驱动隔离功能变化

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

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

6.7  BI RestAPI 数据集插件不兼容

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