Todos os produtos
Search
Central de documentação

Lindorm:Instalar o SDK do ApsaraDB for HBase

Última atualização: Aug 26, 2026

Para conectar-se ao LindormTable, instale o SDK correspondente à linguagem de programação utilizada. Use o SDK do ApsaraDB for HBase para Java ou para outras linguagens na conexão com o Lindorm. Este tópico descreve como instalar o SDK do ApsaraDB for HBase para Java.

Instalar o SDK do ApsaraDB for HBase para Java

Instale o SDK do ApsaraDB for HBase para Java para utilizar todos os recursos do LindormTable. Após a instalação, use esse SDK para conectar-se ao LindormTable e desenvolver aplicações.

Pré-requisitos

Java Development Kit (JDK) V1.8 ou superior instalado.

Importante

O SDK do ApsaraDB for HBase para Java não oferece suporte às versões do JDK 17.

Versões do cliente

  • Ao atualizar um cliente que usa HBase open source 1.x para instalar o SDK do ApsaraDB for HBase para Java, adicione a dependência do ApsaraDB for HBase 1.x.

  • Ao atualizar um cliente que usa HBase open source 2.x, adicione a dependência do ApsaraDB for HBase 2.x.

Nota

Em instalações novas do SDK do ApsaraDB for HBase para Java, selecione a versão mais recente disponível. Por exemplo, se o cliente usa HBase open source 1.1.1 e a versão mais nova do ApsaraDB for HBase é a 1.8.8, instale a versão 1.8.8.

Procedimento

  • Se o cliente usar HBase open source 1.x, adicione a seguinte dependência ao arquivo pom.xml do projeto Maven:

    <dependency>
      <groupId>com.aliyun.hbase</groupId>
      <artifactId>alihbase-client</artifactId>
      <version>1.8.8</version>
    </dependency>
  • Se o cliente usar HBase open source 2.x, adicione a seguinte dependência ao arquivo pom.xml do projeto Maven:

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

Se o ambiente não oferecer suporte a clientes do ApsaraDB for HBase, ou se você costuma usar Hive, Spark ou Flink open source para acessar o LindormTable, utilize um cliente HBase open source para essa conexão.

Ao usar um cliente HBase open source para conectar-se ao LindormTable, observe os seguintes pontos:

  • Clientes HBase open source conectam-se ao LindormTable exclusivamente pela Virtual Private Cloud (VPC), sem suporte a acesso pela Internet.

  • Clientes HBase open source não acessam instâncias Multi-AZ (High-Availability Edition). Apenas instâncias de zona única e instâncias Multi-AZ (Basic Edition) permitem acesso direto por meio desses clientes.

  • O uso de clientes HBase open source pode reduzir o desempenho do LindormTable devido à conversão de protocolos.

  • Diversos recursos do Lindorm ficam indisponíveis ao usar clientes HBase open source, incluindo transmissão compactada, autenticação de requisições, Access Control List (ACL), rastreamento ponta a ponta, além do envio e otimização de configurações do cliente.

  • Conexões via cliente HBase open source exigem o LindormTable na versão 2.6.2.8 ou superior. Para obter detalhes sobre como atualizar a versão do LindormTable, consulte Minor version update.

  • As versões compatíveis do cliente HBase open source variam de 0,98 a 2.x. Para garantir maior estabilidade e segurança, prefira a versão 1.4.0 ou posterior. Versões anteriores a 1.4.0 estão obsoletas, não recebem mais manutenção da comunidade e podem apresentar problemas potenciais.

Uso

Importante

A API do ApsaraDB for HBase para Java não permite acesso a tabelas SQL. Verifique o tipo da tabela de dados antes de conectar-se ao LindormTable.

Antes de usar a API do ApsaraDB for HBase para Java na conexão com o LindormTable, verifique as limitações dessa API. Para mais informações, consulte HBase API limits.

Para obter detalhes sobre o uso e os parâmetros de conexão da API do ApsaraDB for HBase para Java, consulte Use the HBase Java API to connect to and use LindormTable.

Instalar o SDK do ApsaraDB for HBase para linguagens não Java (como C++, Python e Go)

Para obter instruções sobre como instalar o SDK do ApsaraDB for HBase em linguagens não Java, como C++, Python e Go, e usá-lo na conexão com o LindormTable, consulte Access Lindorm Table using a non-Java HBase SDK.

Referências