All Products
Search

This Product

    Tablestore:Overview of HBase Client

    Document Center

    Tablestore:Overview of HBase Client

    Last Updated:Oct 08, 2026

    Tablestore HBase Client gives your Java applications access to Tablestore through the open source HBase API. Use it alongside Tablestore SDKs and Tablestore RESTful API operations. Migrate your existing Tablestore HBase Client applications to Tablestore without rewriting HBase API calls.

    Supported versions

    Tablestore HBase Client is built on Tablestore SDK for Java V4.2.x and later. It supports the following open source HBase API versions:

    • V2.x.x -- compatible with HBase V2.5.10

    • V1.x.x -- compatible with HBase V1.2.0

    Get Tablestore HBase Client

    Choose the Tablestore Tablestore HBase Client version that matches the HBase Client version your application uses. V2.x.x and V1.x.x expose different APIs -- pick the version that matches your current setup.

    HBase Client V2.x.x

    Get Tablestore HBase Client using one of these methods:

    • Clone or download the tablestore-hbase-client project from GitHub.

    • Download the tablestore-hbase-client-2.0.12.zip package directly.

    • Maven

      Tablestore HBase Client V2.0.12 depends on HBase Client V2.5.10 and Tablestore SDK for Java V5.17.4. Add the following dependency to your pom.xml file:

      <dependencies>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore-hbase-client</artifactId>
        <version>2.0.12</version>
    </dependency>
</dependencies>

      To use a different version of HBase Client or Tablestore SDK for Java, override the bundled versions with the <exclusion> element. The following example uses HBase Client V2.5.0 and Tablestore SDK for Java V5.17.0:

      <dependencies>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore-hbase-client</artifactId>
        <version>2.0.12</version>
        <exclusions>
            <exclusion>
                <groupId>com.aliyun.openservices</groupId>
                <artifactId>tablestore</artifactId>
            </exclusion>
            <exclusion>
                <groupId>org.apache.hbase</groupId>
                <artifactId>hbase-client</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.apache.hbase</groupId>
        <artifactId>hbase-client</artifactId>
        <version>2.5.0</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore</artifactId>
        <classifier>jar-with-dependencies</classifier>
        <version>5.17.0</version>
    </dependency>
</dependencies>

    HBase Client V1.x.x

    Get Tablestore HBase Client using one of these methods:

    • Clone or download the tablestore-hbase-client project from GitHub.

    • Download the tablestore-hbase-client-1.2.0.zip package directly.

    • Maven

      Tablestore HBase Client V1.2.0 depends on HBase Client V1.2.0 and Tablestore SDK for Java V4.2.1. Add the following dependency to your pom.xml file:

      <dependencies>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore-hbase-client</artifactId>
        <version>1.2.0</version>
    </dependency>
</dependencies>

      To use a different version of HBase Client or Tablestore SDK for Java, override the bundled versions with the <exclusion> element. The following example uses HBase Client V1.2.1 and Tablestore SDK for Java V4.2.0:

      <dependencies>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore-hbase-client</artifactId>
        <version>1.2.0</version>
        <exclusions>
            <exclusion>
                <groupId>com.aliyun.openservices</groupId>
                <artifactId>tablestore</artifactId>
            </exclusion>
            <exclusion>
                <groupId>org.apache.hbase</groupId>
                <artifactId>hbase-client</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.apache.hbase</groupId>
        <artifactId>hbase-client</artifactId>
        <version>1.2.1</version>
    </dependency>
    <dependency>
        <groupId>com.aliyun.openservices</groupId>
        <artifactId>tablestore</artifactId>
        <classifier>jar-with-dependencies</classifier>
        <version>4.2.0</version>
    </dependency>
</dependencies>

    After migration

    After migrating data from HBase to Tablestore, you no longer manage HBase Server yourself. Tablestore handles infrastructure tasks including table splitting, compaction, and RegionServer management. Use Tablestore HBase Client directly for all table and data operations.

    Billing

    Tablestore HBase Client usage is billed for data reads, data writes, and storage. For details, see Billing overview.

    API compatibility

    Tablestore and HBase have similar data models and features. For API differences between Tablestore HBase Client and native HBase, see Features supported by Tablestore HBase Client.