连接宽表引擎前,您需要根据使用的API安装相应的SDK。Lindorm支持通过HBase Java API和HBase非Java API进行访问。本文介绍如何安装HBase SDK。
安装HBase Java SDK
使用阿里云发行的HBase客户端可以使用Lindorm宽表引擎的所有功能,并享受Lindorm带来的优秀体验。安装HBase Java SDK后,您可以通过HBase Java API访问宽表引擎并进行应用开发。
前提条件
已安装Java环境且JDK为1.8及以上版本。
HBase Java SDK不支持JDK17版本。
版本说明
开源HBase 1.x版本客户端需添加阿里云HBase 1.x版本的依赖。
开源HBase 2.x版本客户端需添加阿里云HBase 2.x版本的依赖。
新用户安装时建议选择阿里云HBase客户端当前版本下最新的子版本。例如您的开源HBase客户端为1.1.1版本,阿里云HBase客户端最新版本为1.8.8,建议您安装1.8.8版本。
安装步骤
如果客户端是开源HBase 1.x版本,请在Maven项目的
pom.xml
文件中添加以下依赖:<dependency> <groupId>com.aliyun.hbase</groupId> <artifactId>alihbase-client</artifactId> <version>1.8.8</version> </dependency>
如果客户端是开源HBase 2.x版本,请在Maven项目的
pom.xml
文件中添加以下依赖:<dependency> <groupId>com.aliyun.hbase</groupId> <artifactId>alihbase-client</artifactId> <version>2.8.7</version> </dependency>
如果您的环境不支持安装阿里云发行的HBase客户端,或您经常通过Hive、Spark、开源Flink(非阿里云托管版)使用Lindorm宽表引擎,为避免配置更改出现错误,建议您使用开源HBase客户端连接并使用Lindorm宽表引擎。
使用开源HBase客户端连接并使用Lindorm宽表引擎需要注意以下问题:
开源HBase客户端不支持通过公网访问Lindorm宽表引擎。
当前不支持通过开源HBase客户端访问多可用区实例。
由于存在协议转换,使用开源HBase客户端直接访问Lindorm宽表引擎可能存在一定的性能损耗。
使用开源HBase客户端无法使用Lindorm的完整功能, 如传输压缩、请求认证、ACL、全链路trace、客户端配置推送和调优等功能。
使用开源HBase客户端直接访问Lindorm宽表引擎前需要将宽表引擎升级到2.6.2.8及以上版本。如何升级,请参见升级小版本。
支持的开源HBase客户端的版本为0.98~2.x版本。
使用方式
HBase Java API不支持访问SQL表,在连接宽表引擎前请先确认数据表的类型。
使用Java API连接宽表引擎前,请先查阅Java API使用限制,详情请参见HBase API使用限制。
Java API的使用和连接参数说明,请参见基于HBase Java API的应用开发。
安装非Java(C++/Python/Go等) SDK
非Java(C++/Python/Go等) SDK的安装及访问方法,请参见通过HBase非Java SDK访问Lindorm宽表引擎。
相关文档
您还可以通过Lindorm提供的HBase客户端工具Lindorm Shell来访问宽表引擎,具体操作,请参见通过Lindorm Shell访问宽表引擎。
通过HBase API创建的表支持通过SQL访问,详情请参见使用SQL访问HBase表。