Apache Phoenix 通过结合联机事务处理和 Hadoop 运行分析平台的完美结合来针对低延迟应用程序，支持标准 SQL 和有包含事务的原子性、隔离性、一致性、持久性的 JDBC API的能力，并且后期绑定灵活，基于 NoSQL 世界的读时模式，以 HBase 作为后台存储。本章本文介绍如何在 FineBI 中连接 Apache Phoenix 数据库。

2.1 配置信息

注：数据库 JAR 包容易和其他 Hadoop 系列的 JAR 包冲突（Hadoop、hive、impala、星环等等），如果连不上，需要删除冲突的数据库的 JAR。

2.2 连接步骤

1）从配置信息驱动下载链接中下载 Apache Phoenix 驱动包，并将驱动包放到%FineBI%\webapps\webroot\WEB-INF\lib下，重启FineBI 。

2）为避免放置 Apache Phoenix 驱动包后工程无法启动，需要使用压缩软件打开驱动包，手动删除驱动包中 javax 文件夹下的 servlet 文件夹和 el 文件夹。如下图所示：

3）登录数据决策系统，选择管理系统>数据连接>数据连接管理，点击新建数据连接，在所有选项下选择Apache Phoenix，如下图所示：

4）点击确定进入数据连接配置页面，按照前面提供的配置信息，输入自身数据库的对应信息。

• 若选择 kerberos 认证，则需填入注册过 kdc 的客户端名称、keytab 密钥路径和 Kerberos 认证对应 URL ，参考 数据连接Kerberos认证 ，如下图所示：

  注：连接前请检查 /etc/hosts 中的机器名对应 IP 是否为局域网 IP；

  检查 /etc/hostname 中机器名设置和 /etc/hosts 中是否配置一致；

  检查 FineBI 所在机器 hosts 配置的 IP+ 机器名是否正确；

  本地连接时需要配置 /etc/hosts 文件，添加远端映射：IP+机器名，例如： 192.168.5.206  centos-phoenix 。

  

• 若不选择 kerberos 认证，则跟其他数据库设置一致，按照本文 2.1 章节提供的配置信息，输入数据库的对应信息，可选择填入高级设置信息，详情参见 配置数据连接 ），如下图所示：

  

5）点击测试连接，或者在模式下点击连接数据库，若弹出「连接成功」提示框，则表示成功连接上数据库，如下图所示：

6）测试连接成功后可以选择模式，根据需要选择对应模式，若不进行选择，则默认为第一个模式。如下图所示：

7）模式选择后点击右上角的保存按钮，该数据连接即添加成功。如下图所示：

3.1 注意事项

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 会报错。

3.2 报错解决方案 

报错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>