什么是SQuirrel?
SQuirreL SQL Client是一个开源免费软件, 可以通过jdbc对多种数据库进行可视化的管理,查询等。本文主要介绍如何通过SQuirrel连接Phoenix并设置Phoenix参数等。
安装SQuirrel访问Phoenix
- 下载最新的SQuirrel客户端
本文下载最新版本的3.8.1版本,下载后为squirrel_sql-3.8.1-standard.jar的可执行包。(环境中需要安装并配置好jdk)
- 安装SQuirreL
双击下载好的可执行jar包,一直点击下一步即可。
- 在云Hbase官网下载最新版的phoneix,
使用不同版本云HBase应下载对应的phoenix包,下载完成后将Phoenix安装包解压,需要注意如果是Phoenix 4.11.0版本,phoenix客户端包名为phoenix-4.11.0-AliHBase-1.1-0.3-client.jar,如果是Phoenix 4.12.0版本则对应ali-phoenix-4.12.0-AliHBase-1.1-0.4-Final-client.jar。
将对应版本的phoenix客户端包拷贝至SQuirreL安装路径下的lib文件夹。
- 启动SQuirreL,可以通过Windows->View SQuirrel Logs查看运行日志。
配置SQuirrel链接Phoenix
- 设置Phoenix JDBC DRIVE。
打开SQuirrel客户端后,点击左侧Drivers进行设置phoenix驱动。
点击+号,新增一个驱动,Name项根据自己需要填写,Website URL可以省略,也可以填写phoenix jdbc驱动串模版:jdbc:phoenix:h1,h2,h3,在Java Class Path栏找到拷贝过来的Phoenix客户端jar包,点击List Drivers,会自动把Phoenix jdbc的驱动类显示在Class Name栏。此时点击OK,Phoenix的驱动就创建完成了。
2.配置Phoenix链接。
在SQuirreL左侧点击Aliases -> 创建一个链接。
Name项根据自己需要填写,Username和Password是访问数据库的账户名和密码(此示例中链接hbase不需要用户和密码,所以这两项为空)。Driver在下拉栏中选择第一步中配置好的Phoenix驱动,URL则需要修改为实际环境中Phoenix连接串,URL模版为jdbc:phoenix:h1,h2,h3,实际使用时需要将h1,h2,h3修改为云HBase环境的zookeeper连接地址。
配置完成后,点击OK完成链接创建,然后connect就可以连接Phoenix了。
在SQuirrel中如何配置Phoenix参数
Phoenix客户端参数可以通过hbase-site.xm文件进行配置,我们只需要将需要配置项填在此文件中,并放置在SQuirrel启动的classpath中就能生效。
以配置phoenix.force.index为例:
在未对phoenix.force.index进行设置时,默认值为true。那么在查询中查询非索引列时会报错。
下载phoenix安装包时,在bin目录下放有hbase-site.xml配置文件,将phoenix.force.index=false配置项添加在该配置文件中。
在SQuirreL安装目录的lib文件夹下新建conf文件夹,并将上一步的hbase-site.xml拷贝至conf文件夹,关闭并重启SQuirreL客户端。
查询非索引列条件,参数生效,查询成功。
注意:如果重启后,参数仍然没有生效,请确认配置文件是否已经正确加载到ClassPath下,可以在Drivers中找到Pheonix驱动,右键选择Modify Driver,查找Java Class path下是否已经包含了conf文件夹。