文档

安装HBase Java SDK

更新时间:

使用阿里云发行的HBase客户端可以使用Lindorm宽表引擎的所有功能,并享受Lindorm带来的优秀体验。本文介绍如何安装阿里云HBase客户端

注意事项

HBase Java SDK不支持JDK17版本。

前提条件

已安装Java环境且JDK为1.8及以上版本。

版本说明

  • 开源HBase 1.x版本客户端需添加阿里云HBase 1.x版本的依赖。

  • 开源HBase 2.x版本客户端需添加阿里云HBase 2.x版本的依赖。

升级HBase Java SDK

说明

新用户安装时建议选择阿里云HBase客户端当前版本下最新的子版本。例如您的开源HBase客户端为1.1.1版本,阿里云HBase客户端最新版本为1.8.8,建议您安装1.8.8版本。

  • 如果客户端是开源HBase 1.x版本,您可以在Maven项目的pom.xml文件中添加以下依赖来安装HBase Java SDK。

    <dependency>
      <groupId>com.aliyun.hbase</groupId>
      <artifactId>alihbase-client</artifactId>
      <version>1.8.8</version>
    </dependency>
  • 如果客户端是开源HBase 2.x版本,您可以在Maven项目的pom.xml文件中添加以下依赖来安装HBase Java SDK。

    <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版本。