驱动管理

1.1 版本

1.2 应用场景

FineBI连接数据库时，可能会因为产品未内置对应版本的数据库驱动而连接失败。

1.3 功能简介

用户可使用「驱动管理」功能，上传对应的驱动。「驱动管理」使用的是热加载，上传驱动后不需要重启 FineBI 即可直接使用驱动 。

当遇到一些驱动导致的问题后，可以快速修改驱动加载方式从而能够实现快速的连接。默认选优先加载当前上传驱动，如下图所示：

• 优先加载当前方式上传驱动：先加载驱动管理的 jar：WEB-INF/drivers/hive/**.jar，若无对应文件则加载应用的 jar：WEB-INF/lib/**.jar。

• 仅加载当前方式上传驱动：仅加载驱动管理的 jar：WEB-INF/drivers/hive/**.jar。

由于大部分用户对工程安全性要求很高，FineBI 默认禁止通过驱动管理上传驱动。

因此使用驱动管理前，需要开启「允许驱动上传」的相关设置。（基于安全策略原因，该设置项无法直接以按钮形式提供，需要用户通过修改配置库字段值实现）

1）管理员登录运维平台，选择该FineBI项目。（FineBI7.0默认必须由运维平台部署，如不了解运维平台，请联系FineBI部署人员确认）

2）点击「业务工具>业务配置更改」，设置参数「SystemConfig.driverUpload」的值为「true」，点击「保存」

• true ：允许通过驱动管理上传驱动

• false：禁止通过驱动管理上传驱动

3）修改成功后，点击「维护>组件管理」。找到FineBI应用节点，点击「重启」，并等待 bi-web 状态至 healthy 。

重启后再次登录 FineBI 系统，即可通过「驱动管理」上传驱动。

3.1 上传数据库驱动

1）管理员登录 FineBI 系统，点击「管理系统>数据连接管理>驱动管理」，如下图所示：

2）点击「新建驱动」，输入名称方便之后与其他驱动区分。这里我们要上传 PostgreSQL 的驱动，可以命名为「postgresql驱动」，如下图所示：

3）点击「上传驱动」，将数据库驱动上传上去。如下图所示：

注：数据库驱动可以在对应数据库的帮助文档下载，也可以让数据库管理员提供。

4）点击下拉按钮，选择一个刚刚上传的驱动，点击「保存」，如下图所示：

注1：若有多个驱动 jar 包，不清楚选择哪个驱动，可以咨询对应的数据库管理员。

注2：驱动管理上传的驱动，会存放在集群文件服务的/assets/drivers文件夹中，并自动同步到每个bi-web容器的WEB-INF/drivers文件夹中。

3.2 使用驱动

1）在「数据连接管理」界面点击「新建数据连接」，新建一个 PostgreSQL 数据连接，如下图所示：

2）驱动选择「自定义」，在后方下拉选择刚刚上传的 postgresql 驱动 ，并填入其他连接信息，详细请参见 Postgresql数据连接 。如下图所示：

3）点击测试连接，可以看到数据库可以成功连接，如下图所示：

3.3 删除驱动

若要删除某个已存在的数据库驱动，可进入驱动管理界面直接点击删除按钮，如下图所示：

5.1.19 及之前版本，无驱动管理功能，用户如需上传驱动，可通过手动上传的方法。

将下载好的驱动包拷贝到 %BI_HOME%\webapps\webroot\WEB-INF\lib 路径下，重启 BI 服务器后驱动生效。如下图所示：

注：若重启后驱动不生效，可能是由于在该目录下存在该驱动的其他版本，需要手动删除其他版本，以防冲突。