HBase SQL(Phoenix) 5.x 使用说明_HBase SQL服务(Phoenix)

Phoenix 5.x 说明

HBase SQL服务基于Phoenix 5.x为HBase 2.x提供SQL能力，通过轻客户端即可快速连接访问。SQL服务挂载了SLB负载均衡，通过round robin模式将请求均匀分发在每个query server节点。此外轻客户端还支持Python、Go等多语言访问。

使用步骤

开通HBase SQL服务

HBase实例开通后，进入控制台管理界面，在左侧菜单栏可以点击HBase SQL服务项->立即开通，即可开通HBase SQL服务。

开通HBase SQL服务时需要重启HBase实例，并占用部分内存资源，请在业务低峰期进行开通，开通过程需要十分钟左右，节点数越多时间会相对越长。

开通之后，后续对SQL服务重启和小版本升级也在该界面，点击相应按钮即可。
SQL服务管理

服务开通后，在HBase SQL服务栏即可看到如下界面：

用户可以在上图所示控制台中对SQL服务进行日常管理，包括SQL服务小版本升级，SQL服务重启，开通公网访问。

需要说明的是，SQL服务连接地址分为负载均衡连接和单点连接，分别在不同的场景中使用：
- 负载均衡连接：使用SLB进行负载均衡，对于高并发读写请求能够均发至后端的多个QueryServer中处理，提升集群的整体吞吐能力。
- 单点连接：使用大表创建索引或使用UPSERT…SELECT导数据以及复杂查询等单点请求场景，由于请求时间过长使用负载均衡连接会出现连接超时断掉情况，需使用单点QueryServer连接。
客户端准备

准备一台ECS，需要和HBase处在同一个网络内，建议是同一个vpc内部的ECS实例，否则需要打通网络，或者使用外网地址连接。

查看这台ECS的内网IP

hostname -i

然后把他加到HBase的网络白名单中。加入的方法请参考HBase白名单控制。
客户端访问HBase SQL服务
- 在准备好的ECS客户机上下载最新版本的HBase SQL客户端：
```
wget https://hbase-opt.oss-cn-hangzhou.aliyuncs.com/ali-phoenix-5.2.4.1-HBase-2.x.tar.gz
```
- 解压客户端压缩包
```
tar zxvf ali-phoenix-5.2.4.1-HBase-2.x.tar.gz
```
- 启动轻客户端工具
```
bin/sqlline-thin.py http://xxx-proxy-phoenix.hbase.rds.aliyuncs.com:8765
```
- 验证
我们在这个命令行中输入:

!tables

如果看到一个表的列表，那么就说明我们配置成功了。可以开始更加深入的使用了。
- 退出
使用quit命令退出Phoenix

!quit

注意：首次连接会创建meta表，需等待一段时间。

Phoenix 5.x vs Phoenix-4.x

Phoenix-5.x对于时区的处理逻辑做了统一优化，请参考云栖文章：Phoenix关于时区的处理方式说明。
Phoenix-5.x使用轻客户端模式，而Phonix-4.x默认提供重客户端模式。轻客户端和重客户端模式请参考云栖文章:Phoenix客户端优化之由重到轻。