Install the HBase SDK and use Lindorm - Lindorm - Centro de documentación de Alibaba Cloud

Para conectarse a LindormTable, debe instalar el SDK correspondiente según el lenguaje que utilice. Puede usar el SDK de ApsaraDB for HBase para Java o un lenguaje distinto de Java para conectarse a Lindorm. Este tema describe cómo instalar el SDK de ApsaraDB for HBase para Java.

Instalar el SDK de ApsaraDB for HBase para Java

Puede instalar el SDK de ApsaraDB for HBase para Java para utilizar todas las funciones proporcionadas por LindormTable. Una vez completada la instalación, podrá usar este SDK para conectarse a LindormTable y desarrollar aplicaciones.

Requisitos previos

Debe tener instalado Java Development Kit (JDK) V1.8 o posterior.

Importante

El SDK de ApsaraDB for HBase para Java no es compatible con las versiones de JDK 17.

Versiones del cliente

Si instala el SDK de ApsaraDB for HBase para Java mediante la actualización de un cliente que usa HBase de código abierto 1.x, debe agregar la dependencia de ApsaraDB for HBase 1.x.
Si instala el SDK de ApsaraDB for HBase para Java mediante la actualización de un cliente que usa HBase de código abierto 2.x, debe agregar la dependencia de ApsaraDB for HBase 2.x.

Nota

Si instala el SDK de ApsaraDB for HBase para Java por primera vez, se recomienda seleccionar la versión más reciente de ApsaraDB for HBase. Por ejemplo, si su cliente utiliza HBase de código abierto 1.1.1 y la versión más reciente de ApsaraDB for HBase es la 1.8.8, se recomienda instalar ApsaraDB for HBase 1.8.8.

Procedimiento

Si su cliente utiliza HBase de código abierto 1.x, agregue la siguiente dependencia al archivo pom.xml de su proyecto Maven:

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

Si su cliente utiliza HBase de código abierto 2.x, agregue la siguiente dependencia al archivo pom.xml de su proyecto Maven:

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

Importante

Si en su entorno no se admiten clientes que utilizan ApsaraDB for HBase, o si habitualmente usa Hive, Spark o Flink de código abierto para conectarse a LindormTable, se recomienda emplear un cliente HBase de código abierto para acceder y utilizar LindormTable.

Tenga en cuenta los siguientes puntos cuando utilice un cliente HBase de código abierto para conectarse y usar LindormTable:

Si utiliza un cliente HBase de código abierto, solo puede conectarse a LindormTable mediante una virtual private cloud (VPC), pero no a través de Internet.
No es posible usar un cliente HBase de código abierto para acceder a una instancia Multi-AZ (High-Availability Edition). Solo las instancias de zona única y las instancias Multi-AZ (Basic Edition) admiten acceso directo mediante un cliente de código abierto.
Al conectar con LindormTable mediante un cliente HBase de código abierto, el rendimiento de LindormTable podría disminuir debido a la conversión de protocolos.
Si utiliza un cliente HBase de código abierto para trabajar con LindormTable, algunas funciones proporcionadas por Lindorm no estarán disponibles, como la transmisión comprimida, la autenticación de solicitudes, la lista de control de acceso (ACL), el rastreo de extremo a extremo, así como la optimización e inserción de configuraciones del cliente.
Para conectarse a LindormTable con un cliente HBase de código abierto, la versión de LindormTable debe ser 2.6.2.8 o posterior. Para obtener más información sobre cómo actualizar la versión de LindormTable, consulte Minor version update.
Las versiones compatibles del cliente HBase de código abierto abarcan desde la 0.98 hasta la 2.x. Para garantizar mayor estabilidad y seguridad, se recomienda utilizar la versión 1.4.0 o posterior. Las versiones anteriores a la 1.4.0 están obsoletas, ya no reciben mantenimiento por parte de la comunidad y podrían presentar problemas potenciales.

Uso

Importante

No es posible utilizar la API de ApsaraDB for HBase para Java para acceder a tablas SQL. Compruebe el tipo de tabla de datos antes de conectarse a LindormTable.

Antes de utilizar la API de ApsaraDB for HBase para Java para conectarse a LindormTable, revise los límites de dicha API. Para obtener más información, consulte HBase API limits.

Para obtener más información sobre el uso y los parámetros de conexión de la API de ApsaraDB for HBase para Java, consulte Use the HBase Java API to connect to and use LindormTable.

Instalar el SDK de ApsaraDB for HBase para un lenguaje distinto de Java (como C++, Python y Go)

Para obtener más información sobre cómo instalar el SDK de ApsaraDB for HBase para un lenguaje distinto de Java, como C++, Python y Go, y cómo utilizarlo para conectarse a LindormTable, consulte Access Lindorm Table using a non-Java HBase SDK.

Referencias

También puede utilizar Lindorm Shell, una herramienta de cliente HBase proporcionada por Lindorm, para conectarse a LindormTable. Para obtener más información, consulte Connect to LindormTable using Lindorm Shell.
Puede ejecutar sentencias SQL para acceder a tablas HBase creadas mediante la API de ApsaraDB for HBase. Para obtener más información, consulte Use SQL to access an HBase table.