直连 Excel 融合分析常见问题

Q1：为什么会提示权限不足？

问题原因

直连 Excel 与数据库表做融合分析时，系统需要将上传的 Excel 数据写入数据库中的临时表或实体表，再基于该表参与左右合并、上下合并等分析计算。

如果当前数据连接使用的数据库用户缺少建表、删表、写入或查询等权限，就无法创建融合分析所需的临时表 / 实体表，从而触发“权限不足”类报错。

常见缺失权限

解决方案

1. 将产品报错中展示的数据连接、数据库用户、数据库名称和缺失权限提供给 BI 管理员或 DBA。

2. 请管理员为该数据连接用户授予必要权限。

3. 授权后返回分析主题，重新执行融合分析或点击「重新预览」。

4. 若仍报错，请保留报错原文，继续交由管理员排查数据库侧权限策略。

问题原因

上传的 Excel 文件行数超过了系统参数 SystemOptimizationConfig.excelExtractMaxLimitRows 的限制。当前默认限制为 10000 行。

当 Excel 行数超过该限制时，系统会阻止继续处理，避免大文件上传、解析、写入数据库和融合分析时造成性能或内存问题。

解决方案一

将 Excel 拆分为多个小文件，每份不超过 10000 行。

解决方案二

如确实需要支持更大行数，管理员可调整参数 SystemOptimizationConfig.excelExtractMaxLimitRows，例如将 10000 设置为更大值 50000。修改操作请参见：fine_conf_entity可视化配置 ，修改后重启工程。

调大行数限制可能影响 Excel 表和数据库表融合分析的性能。因此建议在帆软技术人员或管理员评估后操作，不建议用户自行调整。

解决方案三

将 Excel 数据直接导入数据库后使用。

直连 Excel 融合分析需要将 Excel 数据上传到当前数据连接对应的数据库中，再通过临时表或实体表参与融合分析。因此，并非所有直连数据源都支持该能力。当前支持的数据源：[直连]支持与Excel融合分析的数据库

问题原因

在 MySQL / GBase 8a 等数据库中，临时表存在会话级限制：同一会话内不能在同一条 SQL 中多次打开同一张临时表。

直连 Excel 与数据库表融合分析后，如果后续分析步骤生成的 SQL 多次引用同一张临时表，例如使用窗口函数、子查询等场景，就会出现这个报错。

解决方案一

将 Excel 数据直接导入数据库作为实体表，再基于实体表分析。

解决方式二

在 FineBI 中不用直连模式，改用抽取模式进行分析。

解决方式三

避免在当前直连 Excel 融合分析结果上使用容易触发临时表 reopen 的分析方式。

如必须使用该分析逻辑，可尝试在数据库侧提前加工数据，再在 FineBI 中分析。

产品默认会对 Excel 文本字段长度进行限制，默认截断长度为 255 字符。

如需调整截断长度，可修改参数 SystemOptimizationConfig.excelStringColLength。该参数表示 Excel 文本字段允许保留的最大字符数。例如设置为 400 时，400 字符以内的内容会保留，超过 400 字符的部分才会被截断。修改方式请参见：fine_conf_entity 可视化配置。修改后需重启工程生效。

调整前请评估性能和存储影响。字段长度设置越大，可能带来更高的数据库存储成本和查询性能开销。

Doris / StarRocks 建表时通常需要指定副本数，即同一份数据在 BE 节点上保存几份副本。副本数越高，数据可靠性越高，但需要更多可用 BE 节点和存储资源。

直连 Excel 融合分析会将 Excel 数据写入 Doris / StarRocks 中的实体表。如果建表 SQL 中指定的副本数大于当前可用 BE 节点数，数据库可能无法创建表。例如当前只有 1 个可用 BE 节点，但建表要求 replication_num = 3，就可能触发副本数不足或建表失败。

检查 BE 节点方法

可由 DBA 执行以下 SQL，查看 BE 节点状态：SHOW BACKENDS; 然后再统计 Alive = true 的 BE 节点个数即可。

解决方法

如果可用 BE 节点数少于建表副本数，需要调低表副本数，或先恢复 / 扩容 BE 节点。