1. 概述编辑
1.1 版本
FineBI版本 | JAR 包版本 |
5.1 | 2019-12-20/待定 |
1.2 应用场景
在创建数据连接时,可能会出现放置的新驱动 JAR 包和 FineBI 自带的 JAR 包,或者和其他驱动 JAR 包有冲突的问题(例如 Hive 的 hadoop 的套件冲突或者 hive 和星环数据库的 JAR 包冲突),为此 FineBI 提供驱动隔离插件来隔离相关的驱动,以保证数据库顺利连接。
1.3 功能描述
本章插件用于隔离数据库 JDBC 的驱动 JAR 包,以避免驱动的 JAR 包和 FineBI 自带的 JAR 包以及驱动与驱动之间的 JAR 包有冲突的问题。
2. 插件介绍编辑
2.1 插件安装
点击下载插件:
数据库名 | 插件 |
Hive | |
TRANSWARP INCEPTOR (星环) | |
SPARK | fr-plugin-spark-driver-loader-2.0.zip |
MySQL | |
Apache Impala | |
Oracle | |
Presto |
2.2 操作方法
将对应 JAR 包放入指定文件夹即可。
注:Hive 数据库和 TRANSWARP INCEPTOR (星环)、SPARK 数据库需要在对应 JAR 包的文件夹中放入
3. 示例编辑
3.1 Hive 驱动隔离
1)在 FineBI 路径%FineBI%/webapps/webroot/WEB-INF下,建立一个新的文件夹:数据库名+driverlib,示例为 Hivedriver 。将对应驱动 JAR 包放入该文件夹。可以根据数据库版本选择需要的驱动,如下表所示:
支持数据库版本 | 驱动下载 |
---|---|
hive_1.1; | |
Hadoop_2.6.3_Hive_1.2.1;hive2.3;hive2.1.1; |
2)由于 Hive 驱动依赖 slf4j 的 JAR 包,所以需要将
slf4j-api-1.7.10 .jar 和 slf4j-log4j12-1.7.10 .jar 也放入 Hivedriver 文件夹中,如下图所示:
注:此处使用了隔离插件以后,驱动 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 的版本后,原 驱动隔离插件 插件不兼容,需要手动更换新插件。