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

目录:

1. 概述编辑

1.1 版本

FineBI版本JAR 包版本
5.12020-1-15

1.2 应用场景

在创建数据连接时,可能会出现放置的新驱动 JAR 包和 FineBI 自带的 JAR 包,或者和其他驱动 JAR 包有冲突的问题(例如 Hive 的 hadoop 的套件冲突或者 hive 和星环数据库的 JAR 包冲突),为此 FineBI 提供驱动隔离插件来隔离相关的驱动,以保证数据库顺利连接。

1.3 功能描述

本章插件用于隔离数据库 JDBC 的驱动 JAR 包,以避免驱动的 JAR 包和 FineBI 自带的 JAR 包以及驱动与驱动之间的 JAR 包有冲突的问题。

2. 插件介绍编辑

2.1 插件安装

点击下载插件:

数据库名插件
Hive

fr-plugin-hive-driver-loader-2.0.zip

TRANSWARP INCEPTOR (星环)

fr-plugin-transwarp-driver-loader-2.0.zip

SPARK

fr-plugin-spark-driver-loader-2.0.zip


MySQL

fr-plugin-mysql-driver-loader-2.0.zip

Apache Impala

fr-plugin-impala-driver-loader-2.0.zip

Oracle

fr-plugin-oracle-driver-loader-2.0.zip

Presto

fr-plugin-presto-driver-loader-2.0.zip

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

2.2 操作方法

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

注:Hive 数据库和 TRANSWARP INCEPTOR (星环)、SPARK 数据库需要在对应 JAR 包的文件夹中放入

slf4j-log4j12-1.7.10 .jar 、slf4j-api-1.7.10 .jar JAR 包。

3. 示例编辑

3.1 Hive 驱动隔离

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

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

Hive1.1 .rar


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

Hadoop Hive .zip


注:对文件夹命名需按照如下格式:

数据库文件夹名
Hivehivedriverlib
TRANSWARP INCEPTOR (星环)transwarpdriverlib
SPARKsparkdriverlib
MySQLmysqldriverlib
Apache Impalaimpaladriverlib
Oracleoracledriverlib
Prestoprestodriverlib

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

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

1577157045859387.png

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

3)安装完成后,重启 FineBI 服务器,在数据连接中连接数据库即可。详情参见:配置数据连接

4. 注意事项编辑

4.1 隔离插件支持条件

1)使用隔离插件后不支持 kerberos 认证。

2)隔离插件细分不同的数据连接,即使底层使用了同样的数据库也会区分不同的名字。例如:SPARK,Hive 和 TRANSWARP INCEPTOR (星环)数据库的底层都是 Hive 数据库,但使用的插件是不同的,放置 JAR 包的文件夹名称也应该区别。

3)由于隔离的文件夹名不同,所以安装多个插件后,对应驱动均可以隔离。

4.2 兼容问题

1)若 2019-07 的版本升级到 2020-01 的版本后,原 驱动隔离插件 插件不兼容,需要手动更换新插件。