历史版本4 :5.1.1 版本驱动隔离插件 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

         FineBI版本                 jar包版本            
5.1 2019-07-31

1.2 应用场景

用户经常会出现驱动的 jar 包和 FineBI 自带的 jar 包中有冲突的问题(例如 hive 的 hadoop 套件冲突),为此 FineBI 提供一个驱动隔离插件来隔离相关的驱动,以保证驱动冲突问题不再出现。

1.3 功能描述

该插件用于隔离数据库 JDBC 的驱动jar 包,以避免驱动的 jar 包和 FineBI 自带的 jar 包中有冲突的问题。

2. 插件介绍编辑

2.1 插件安装

点击下载插件:驱动隔离插件

插件安装方法请参见:插件管理 

2.2 操作方法

将对应 jar 包放入指定文件夹即可。

3. 示例编辑

3.1 Hive 驱动隔离

1)在 FineBI 路径%FineBI%/webapps/webroot/WEB-INF下,建立一个新的文件夹:driverlib,将对应驱动 jar 包放入该文件夹。可以根据数据库版本选择需要的驱动,如下图所示:

  支持数据库版本驱动下载 
    hive_1.1;

Hive1.1.rar


Hadoop_2.6.3_Hive_1.2.1;hive2.3;hive2.1.1;

Hadoop Hive.zip

2)由于 Hive 驱动依赖 slf4j 的 jar 包,所以需要将

slf4j-api-1.7.10 .jar 和  slf4j-log4j12-1.7.10 .jar 也放入 dirverlib 文件夹中,如下图所示:

1.png

注:此处使用了隔离插件以后,驱动 jar 包不需要再放入原 %FineBI%/webapps/webroot/WEB-INF/lib 目录下。

3)安装完成后,重启 BI 服务器,在数据连接中连接数据库即可。

3.2 其他驱动隔离

若使用其他驱动,则将 DRIVER_NAME_KEY 修改为指定驱动即可。具体操作步骤如下:

1)下载本章第二节提供的 Hive 驱动隔离插件。

2)修改 com.fr.plugin.dialect.classloader.ClassLoaderHandler 中的 DRIVER_NAME_KEY 值为指定驱动,如下图所示:

1.png

如 db2 驱动为 com.ibm.db2.jcc.DB2Driver ,则该 DRIVER_NAME_KEY 值修改为 com.ibm.db2.jcc.DB2Driver ,详情参考 BI 数据连接中的驱动器名修改;

3)修改完成后保存编译并安装插件。

4)在 FineBI 路径%FineBI%/webapps/webroot/WEB-INF下,建立一个新的文件夹:driverlib,将对应驱动 jar 包放入该文件夹。

5)安装完成后,重启 BI 服务器,在数据连接中连接数据库即可。

4. 注意事项编辑

1)此隔离插件只能解决驱动 jar 与 BI 自带的 jar 的冲突问题,无法解决驱动和驱动之间的冲突问题(比如 hive 和星环的冲突)。