1. 概述
1.1 版本
| FineBI 版本 | 功能变动 |
|---|---|
| 5.1 | - |
| 5.1.19 | 更改上传数据库驱动包的方式：通过「驱动管理」上传，实现热加载 |
1.2 应用场景
本文将介绍如何在 FineBI 中连接 Apache Phoenix 数据库。
2. 准备工作
2.1 版本和驱动
| 支持的数据库版本 | 驱动下载链接 | 支持数据库版本 |
|---|---|---|
1.2 | phoenix-4.12.0-HBase-1.2-client.jar | org.apache.phoenix.jdbc.PhoenixDriver |
2.2 收集连接信息
在连接数据库之前，请收集以下信息：
数据库所在服务器的 IP 地址和端口号；
数据库的名称；
若是用户名密码认证，需要收集用户名和密码；若是 Kerberos 认证，需要收集客户端 principal 和 keytab 密钥路径；
需要连接的数据库模式；
3. 具体连接步骤
1）以管理员身份登录 FineBI ，点击「管理系统>数据连接>数据连接管理」，点击「新建数据连接」，如下图所示：
注：如果非管理员用户想要配置数据连接，需要管理员给其分配管理系统下数据连接节点的权限，具体操作请查看 数据连接权限
2）找到 APACHE Phoenix 的图标，如下图所示：
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%\webapps\webroot\WEB-INF\lib后，重启 FineBI ，FineBI 一直处于启动页面。如下图所示：
解决方法：
1）使用压缩工具打开 phoenix-4.12.0-HBase-1.2-client.jar 文件，进入 javax 文件，删除 el 和 servlet 文件，如下图所示：
3）重启 FineBI 即可。
5.2 查询语句
1）A join B on A.a=B.b，A B 不支持子查询。
2）尽量避免使用多层嵌套 SQL 语句。多层嵌套可能会 SQL 报错，如果用户原本的 SQL 数据集已经有 SQL 嵌套, 引擎开启实时数据时的查询可能会出现问题。
例如 SQL 语句 select T_2.a from ( select T_1.a from ( select * from A) T_1 ) T_2 会报错。
5.3 问题报错及解决方案
1）描述：JDBC 访问数据库无法连接, 提示 get locations 错误或者 zookeeper 找不到对应的地址。
解决方法：
检查/etc/hosts 中的机器名对应IP是否为局域网IP；
检查/etc/hostname中机器名设置和/etc/hosts中是否配置一致；
检查 BI 所在机器 hosts 配置的 IP+ 机器名是否正确。
2）描述：BI 测试连接失败, 报错 Caused by: java.sql.SQLException: org.apache.hadoop.hbase.DoNotRetryIOException: java.lang.IllegalAccessError: tried to access method com.google.common.base.Stopwatch.<init>()V from class org.apache.hadoop.hbase.zookeeper.MetaTableLocator
解决方法：
将 guava 包替换为 guava-16.0.1.jar 。
3）描述：BI 测试连接失败，报错：ERROR 726 (43M10): Inconsistent namespace mapping properties. Cannot initiate connection as SYSTEM:CATALOG is found but client does not have phoenix.schema.isNamespaceMappingEnabled enabledERROR 726 (43M10): Inconsistent namespace mapping properties. Cannot initiate connection as SYSTEM:CATALOG is found but client does not have phoenix.schema.isNamespaceMappingEnabled enabled报错截图：
解决方法：
如果使用了 Hbase 中的自定义 namespace ，不仅仅使用 default ，那么在 Phoenix 中与之对应的是 schema 的概念。但是默认并没有开启，需要在 hbase-site.xml 中增加以下配置项：
具体代码如下所示：
<property>
<name>phoenix.schema.isNamespaceMappingEnabled</name>
<value>true</value>
</property>
<property>
<name>phoenix.schema.mapSystemTablesToNamespace</name>
<value>true</value>
</property>
