1 概述
本文介绍了如何连接带kerberos认证的星环数据库。
2 数据连接
2.1 环境准备
（1）找到服务器路径下的hosts文件：
- Windows环境路径：C:\Windows\System32\drivers\etc
- Linux环境路径：/etc/hosts
（2）打开hosts文件，添加所有星环集群节点服务器、kerberos认证服务器的IP跟主机名映射关系。
2.2 上传Kerberos认证文件
联系星环数据库管理员获取Krb5文件、KeyTab文件，并上传到Smartbi的服务器上。
1）注意：需要确保smartbi服务器时间和星环数据库集群的时间同步。
2.3 配置自定义驱动包
操作步骤 | 说明 |
|---|---|
| 1、登录星环web端 | 启动并登录星环数据库，输入用户名、密码，登陆界面如图：
|
| 2、下载jdbc驱动客户端 | 1）进入星环数据管理界面，点击进入Inceptor服务界面。
2）点击右上角 更多操作 > 下载JDBC驱动 。
|
| 3、加载驱动 | （1）访问Smartbi的配置界面，URL为“http://server: port/Smartbi/vision/config.jsp”，在“业务库驱动”中配置驱动的路径。
以上路径为默认的相对路径，其绝对路径为 “Smartbi启动目录/dynamicLibraryPath”；如果使用exe安装，对应目录即为 “Smartbi安装目录/tomcat/bin/dynamicLibraryPath”；也可自行制定路径。 关于该设置项说明请参考：Smartbi Config页面介绍 。 （2）在dynamicLibraryPath目录下新建一个文件夹，然后将驱动文件放到新建文件夹下：
10秒左右Smartbi系统会自动检测到该jar文件并加载，无需重启服务器。 |
2.4 连接步骤
（1）在数据连接的关系数据库中，选择新建星环数据源。
（2）配置连接信息如图：
主要配置信息说明：
配置项 | 说明 |
|---|---|
| 名称 | 数据源连接名称，不可为空 |
| 驱动程序存放目录 | 选择“自定义”并在下拉框中选择”XINGHUAN" |
| 连接字符串 | jdbc:hive2://10.10.204.60:10000/default;principal=hive/tdh02@TDH;kuser=hive@TDH;keytab=/opt/kerberos/xinghuan/hive.keytab;krb5conf=/ opt/kerberos/xinghuan/krb5.conf;auth=kerberos |
| 连接方式 | Kerberos认证 |
| 客户端PR | keytab文件对应的principal，由星环数据库集群管理员提供，如果连接字符串配置了principal参数，此处可以不填写 |
| Krb5文件路径 | krb5.conf的存放路径，krb5.conf文件由星环数据库集群管理员提供，如果连接字符串配置了krb5conf文件路径，此处可以不填写 |
| KeyTab文件路径 | keytab的存放路径，keytab文件由星环数据库集群管理员提供，如果连接字符串配置了keytab文件路径，此处可以不填写 |
| Kuser | 系统用户，由星环数据库集群管理员提供，如果连接字符串配置了kuser参数，此处可以不填写 |
1）keytab与krb5conf文件路径更换成Smartbi所在机器的路径，Linux与Windows分隔符都只能使用 "/"；
2）keytab文件、krb5.conf文件、principal信息必须互相匹配。
（3）点击 测试连接 按钮，提示连接成功后保存，连接星环数据库完成。
