Install ApsaraDB for HBase SDK and use Lindorm - Lindorm

To connect to LindormTable, you need to install the corresponding SDK based on the language that you use. You can use ApsaraDB for HBase SDK for Java or a non-Java language to connect to Lindorm. This topic describes how to install ApsaraDB for HBase SDK for Java.

Install ApsaraDB for HBase SDK for Java

You can install ApsaraDB for HBase SDK for Java to use all features provided by LindormTable. After the installation is complete, you can use ApsaraDB for HBase SDK for Java to connect to LindormTable and develop applications.

Prerequisites

Java Development Kit (JDK) V1.8 or later is installed.

Important

ApsaraDB for HBase SDK for Java does not support JDK 17 releases.

Client versions

If you install ApsaraDB for HBase SDK for Java by upgrading a client that uses open source HBase 1.x, you must add the dependency on ApsaraDB for HBase 1.x.
If you install ApsaraDB for HBase SDK for Java by upgrading a client that uses open source HBase 2.x, you must add the dependency on ApsaraDB for HBase 2.x.

Note

If you install ApsaraDB for HBase SDK for Java for the first time, we recommend that you select the latest ApsaraDB for HBase version. For example, if your client uses open source HBase 1.1.1 and the latest ApsaraDB for HBase version is 1.8.8, we recommend that you install ApsaraDB for HBase 1.8.8.

Procedure

If your client uses open source HBase 1.x, add the following Maven dependencies to the pom.xml file:

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

If your client uses open source HBase 2.x, add the following Maven dependencies to the pom.xml file:

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

Important

If clients that use ApsaraDB for HBase are not supported in your environment, or you usually use Hive, Spark or open source Flink to connect to LindormTable, we recommend that you use an open source HBase client to connect to and use LindormTable.

Take note of the following items when you use an open source HBase client to connect to and use LindormTable:

If you use an open source HBase client, you can connect to LindormTable only by using the virtual private cloud (VPC) but not the Internet.
Open source HBase clients cannot be used to access Lindorm instances deployed across multiple zones.
If you use an open source HBase client to connect to LindormTable, the performance of LindormTable may be degraded due to protocol conversion.
If you use an open source HBase client to use LindormTable, some features provided by Lindorm cannot be used, such as compressed transmission, request authentication, Access Control List (ACL), end-to-end tracing, and client configuration pushing and optimization.
If you use an open source HBase client to connect to LindormTable, the version of LindormTable must be 2.6.2.8 or later. For more information about how to the upgrade the version of LindormTable, see Upgrade the minor engine version of a Lindorm instance.
The version of open source HBase used by the client must be 0.98 to 2.x.

Usage

Important

You cannot use the ApsaraDB for HBase API for Java to access SQL tables. Check the data table type before you connect to LindormTable.

Before you use the ApsaraDB for HBase API for Java to connect to LindormTable, check the limits on the ApsaraDB for HBase API. For more information, see Limits.

For more information about the usage and connection parameters of the ApsaraDB for HBase API for Java, see Use ApsaraDB for HBase API for Java to develop applications.

Install ApsaraDB for HBase SDK for a non-Java language (such as C++, Python, and Go)

For more information about how to install ApsaraDB for HBase SDK for a non-Java language such as C++, Python, and Go, and how to use ApsaraDB for HBase SDK for a non-Java language to connect to LindormTable, see Use ApsaraDB for HBase SDK for a non-Java language to connect to LindormTable.

References

You can also use Lindorm Shell, an HBase client tool provided by Lindorm, to connect to LindormTable. For more information, see Use Lindorm Shell to connect to LindormTable.
You can execute SQL statements to access HBase tables that are created by using the ApsaraDB for HBase API. For more information, see Use SQL to access an HBase table.