1. 概述
1.1 版本
FineBI 版本 | 功能变动 |
---|---|
5.1 | - |
5.1.19 | 更改上传数据库驱动包的方式:通过「驱动管理」上传,实现热加载 |
1.2 应用场景
本文将介绍如何连接 Hbase 数据源。
2. 准备工作
2.1 版本和驱动
支持的数据库版本 | 本文示例驱动下载 | 支持数据库版本 |
---|---|---|
1.2 | phoenix-4.12.0-HBase-1.2-client.jar | org.apache.phoenix.jdbc.PhoenixDriver |
注:该驱动包也需要放置到 hbase/lib 下,然后重启 Hbase ( 使用命令./stop-hbase.sh, 再./start-hbase.sh)
2.2 收集连接信息
在连接数据库之前,请收集以下信息:
数据库所在服务器的 IP 地址和端口号;
数据库的名称;
若是用户名密码认证,需要收集用户名和密码;若是 Kerberos 认证,需要收集客户端 principal 和 keytab 密钥路径;
需要连接的数据库模式;
3. 具体连接步骤
1)以管理员身份登录 FineBI ,点击「管理系统>数据连接>数据连接管理」,点击「新建数据连接」,如下图所示:
注:如果非管理员用户想要配置数据连接,需要管理员给其分配管理系统下数据连接节点的权限,具体操作请查看 数据连接权限
2)找到 Hbase 的图标,如下图所示:
3)驱动切换为「自定义」选择 2.1 节上传的驱动,然后输入 2.2 节的连接信息。
Hbase 支持 Kerberos 认证,Kerberos 认证方式详情可参见:数据连接Kerberos认证
注:用户可以选择性修改高级设置,详细请参见 配置数据连接 4.3 节
4)点击「点击连接数据库」,连接成功后选择数据库模式(若不选则使用默认模式)。最后保存该数据连接,如下图所示:
4. 添加数据库的表至 FineBI
5. 注意事项
5.1 FineBI 一直处于启动页面
问题现象:
phoenix-4.12.0-HBase-1.2-client.jar放入 FineBI 安装目录FineBI/webapps/WebReport/WEB-INF/lib后,重启 FineBI ,FineBI 一直处于启动页面。如下图所示:
解决方法:
1)使用压缩工具打开phoenix-4.12.0-HBase-1.2-client.jar文件,进入javax文件,删除el和servlet文件,如下图所示:
3)重启 FineBI 。
5.2 添加数据集
Hbase 数据连接成功后,添加实时 SQL 数据集并制作自助数据集时,暂不支持数据库表中带有小写和特殊符号(如“.”)的字段名。若需要添加此类字段,建议使用抽取数据。
5.3 JDBC 访问数据库无法连接
问题现象:
JDBC 访问数据库无法连接, 提示 get locations 错误或者 zookeeper 找不到对应的地址。
解决方案:
连接前请检查 /etc/hosts 中的机器名对应 IP 是否为局域网 IP;
检查 /etc/hostname 中机器名设置和 /etc/hosts 中是否配置一致;
检查 FineBI 所在机器 hosts 配置的 IP+ 机器名 是否正确。
本地连接时需要配置 /etc/hosts 文件,添加远端映射:IP+机器名,例如: 192.168.5.206 centos-phoenix
5.4 使用 SQuirrel 连接方法
解决方案:
参考 http://phoenix.apache.org/installation.html#SQL_Client,在 https://sourceforge.net/projects/squirrel-sql/?source=typ_redirect 下载 SQuirrel ,默认安装后,将 phoenix-xxxx-client.jar 放到%SQuirrel_HOME%/lib下,启动 SQuirrel 后, 先添加驱动再添加 Alias 即可。
6. 连接异常问题
6.1 问题描述
连接华为大数据平台 Hbase 数据库异常,使用帮助文档中的驱动,会报错:Unable to find org.apache.hadoop.hbase.ipc.NettyRpcClient ,NettyipcCilent 方法找不到,如下图所示:
6.2 原因分析
当前数据库环境对 configration 有额外配置,按以往方式连接会出现配置文件读取异常。
6.3 解决方案
调整配置文件和连接 URL 的写法,解决校验问题,实现数据库直连。
修改配置文件:将使用的配置方法写入到 Hbase-siste.xml 中,再放入到相关的 jar 包中
修改 URL :Hbase数据连接 URL 格式改为:jdbc:phoenix:quorum:port/database:pricinpal:keytabPath,通过解析 URL 可以得到相关属性,并且会优先使用 URL 中得到的属性配置。