[How to] Phoenix 与 CDH5.4.2 HBase的整合

1.简介

　　Phoenix将SQL带回到了NOSQL的世界，其在HBase之上做了一个layer，客户端通过SQL调用Phoenix，Phoenix在转化为HBase客户算API进行访问HBase，其很多计算也是通过HBase的协处理器的机制来完成的。当前很多场景下使用CDH版本的HBase,可惜Cloudrea公司并没有官方支持，内有将Phoenix纳入发布版本中，所以造成社区的Phoenix并不能很好的和HBase的cdh版本进行继承，本文通过重新编译Phoenix的方式将两者结合。

2.Phoenix版本选取

　　Phoenix并没有纳入CDH正式版本中。现在只是CDH版本的lab项目，基于这一点如果我们要使用CDH版本的HBase所适配的Phoenix则需要自己去编译。网上也有很多编译方法，但是这些方法在修改完毕POM文件中的HBase版本后（指定为CDH的HBase版本）通常编译不能通过，唯一的方法是修改Phoneix的源代码，这种在没有经过完整测试的情况下是很危险的，即使修改完毕代码后编译通过对于后续在使用在也是后果自负。

CDH对于Phoneix纳入lab项目的官方声明如下：

　　http://blog.cloudera.com/blog/2015/05/apache-phoenix-joins-cloudera-labs/

　　对于Phoneix的工作在如下git中进行，我们可以根据当前自身的HBase版本来选取对应的phoinex版本：

　　https://github.com/cloudera-labs/phoenix

　　　　

在我们的生产环境使用的cdh5.4.2版本的HBase，所以在上述git中选取最接近的1.1.0分支，正如上述，虽然是lab版本但是对于“胡乱”修改代码自行编译的版本还是靠谱些。

　　我们也可以在Cloudera的下载目录中找到Phoneix的版本，但是这些都是parcel格式，这种格式的文件只能通过cloudera manager来安装！

　　http://archive.cloudera.com/cloudera-labs/phoenix/parcels/

3.Phoenix的安装

　　Phoneix并不是以集群方式或者说起并没有独立的runtime环境，主要以客户端包被继承与应用客户端来运行，以服务端包被继承于HBase服务端来运行，在客户端将“sql”语句解析成HBase的API来进行访问，当进行二级索引的操作的时候又使用到协处理机制来处理主表与索引表的记录等。

安装方法：

• 将 phoenix-[version]-server.jar 加入到HBase节点的classpath中，通常可以直接放入带lib目录下。
• 修改配置文件

• <property>
    <name>hbase.regionserver.wal.codec</name>
    <value>org.apache.hadoop.hbase.regionserver.wal.IndexedWALEditCodec</value>
  </property><property>
    <name>hbase.region.server.rpc.scheduler.factory.class</name>
    <value>org.apache.hadoop.hbase.ipc.PhoenixRpcSchedulerFactory</value>
    <description>Factory to create the Phoenix RPC Scheduler that uses separate queues for index and metadata updates</description>
  </property>
  <property>
    <name>hbase.rpc.controllerfactory.class</name>
    <value>org.apache.hadoop.hbase.ipc.controller.ServerRpcControllerFactory</value>
    <description>Factory to create the Phoenix RPC Scheduler that uses separate queues for index and metadata updates</description>
  </property><property>
    <name>hbase.master.loadbalancer.class</name>
    <value>org.apache.phoenix.hbase.index.balancer.IndexLoadBalancer</value>
  </property>
  <property>
    <name>hbase.coprocessor.master.classes</name>
    <value>org.apache.phoenix.hbase.index.master.IndexMasterObserver</value>
  </property>
  <property>
    <name>hbase.coprocessor.regionserver.classes</name>
    <value>org.apache.hadoop.hbase.regionserver.LocalIndexMerger</value>
  </property>

• 重启集群
• 将 phoenix-[version]-client.jar 继承到应用程序中.

4. bug fix

　　此版本在limit上有一个bug需要解决，patch：PHOENIX-2601