关系型数据源-星环数据连接

1 概述

本文介绍如何在smartbi V10以上版本中连接星环数据库。

2 数据连接

2.1 配置信息

驱动程序类	连接字符串	驱动程序存放目录	支持数据库版本
org.apache.hive.jdbc.HiveDriver	jdbc:hive2://<servername>:10000/default	自定义	星环 5.1.2

1）连接字符串主要信息说明：

<servername>：数据库的地址，一般可以向数据库管理员获取；

10000：数据库默认端口；

default：数据库名称，此处使用默认。

2.2 配置自定义驱动

操作步骤

说明

1、获取驱动

1）进入星环数据库管理界面、进入Inceptor服务界面

2）进入inceptor服务界面后，点击右上角 更多操作 > 下载JDBC驱动。

3）下载下来的驱动为：inceptor-driver-5.1.2.jar

2、放置驱动

1）进入到<Smartbi_PATH\Tomcat\bin\dynamicLibraryPath文件夹下，手动添加xinghuan文件夹。

2）然后进入xinghuan文件夹下，添加xinghaun驱动，10秒左右smartbi系统会自动检测到该jar文件，并加载。

3）最后在数据源连接时需要点击自定义选项，选择xinghuan.

产品默认不内置星环JDBC驱动，不建议把驱动放在产品war包内置的lib目录 ；
部分较新的版本，如inceptor-driver-5.1.2以后的版本，可能会存在jar包缺少或冲突的情况；
jar包冲突：如查询date类型的字段，查询可能会执行SQL报错Log jar冲突：Invalid class loader hierarchy. You have more than one version of 'org.apache.commons.logging.Log' visible, which is not allowed；

jar包缺少：测试连接报错提示NoClassDefFoundError等信息

冲突处理方案：

1）确保移除产品war内置lib目录下的星环JDBC驱动驱动，驱动使用自定义；

2）自定义目录的星环驱动目录内新建properties文件，文件内容 loadFromParentPackages=org.apache.commons.logging多个冲突的包名用英文逗号分隔，确保这些包下的所有类优先从产品中加载

缺少处理方案：

1）确保移除产品war内置lib目录下的星环JDBC驱动驱动，驱动使用自定义；

2)自定义目录下只放置星环的JDBC普通包，测试连接看能否成功；

如果报错提示NoClassDefFoundError，如：java.lang.NoClassDefFoundError: com/ctc/wstx/io/InputBootstrapper，可以尝试先借助产品的【系统监控】-【类查找】功能，找到该类所在的jar ，并把该jar添加到自定义驱动目录下。如果产品中找不到，需要去数据库的官网提供的所有依赖jar，再去查找对应的jar添加

3. 注意事项：自定义目录下的星环驱动文件名不能命名为HUAWEI、HADOOP_HIVE、IMPALA、SPARK_SQL，也不能添加properties文件（设置项为：useParentClassLoader=true），否则会引起Tomcat服务挂掉。上述情况只适用于较低版本产品内置了Kerberos认证jar包，华为等hive数据库对其有依赖的情况下，才需要设置父加载器为加载器。星环JDBC驱动inceptor-driver-5.1.2以后的版本，父加载会引起严重BUG，可能与日志log的jar冲突有关