All Products
Search
Document Center

ApsaraDB for HBase:Use ApsaraDB for HBase SDK for Java to replace an open source HBase version with an ApsaraDB for HBase version

Last Updated:Mar 28, 2026

Switch your Java client from open-source HBase to ApsaraDB for HBase by replacing a single Maven dependency in your pom.xml.

Prerequisites

Before you begin, ensure that you have:

  • Java installed

  • ApsaraDB for HBase SDK for Java version 1.8 or later

  • Maven as your project build tool

Version mapping

The ApsaraDB for HBase SDK follows the same major version line as open-source HBase:

Open-source HBase versionApsaraDB for HBase version
1.x1.x
2.x2.x

Replace the Maven dependency

Note

If this is your first time using ApsaraDB for HBase SDK for Java, use the latest available version rather than matching the exact open-source version. For example, if your client uses open-source HBase 1.1.1, replace it with ApsaraDB for HBase 1.8.8.

For HBase 1.x clients

Add the following dependency to your pom.xml:

<dependency>
  <groupId>com.aliyun.hbase</groupId>
  <artifactId>alihbase-client</artifactId>
  <version>1.8.8</version>
</dependency>

For HBase 2.x clients

Add the following dependency to your pom.xml:

<dependency>
  <groupId>com.aliyun.hbase</groupId>
  <artifactId>alihbase-client</artifactId>
  <version>2.8.7</version>
</dependency>