Instale o SDK do HBase e use o Lindorm - Lindorm: Central de Documentação do Alibaba Cloud

Para conectar-se ao LindormTable, instale o SDK do ApsaraDB for HBase correspondente à sua linguagem de programação. As instruções a seguir aplicam-se ao SDK para Java. Para C++, Python e Go, consulte Use o SDK do ApsaraDB for HBase para uma linguagem não Java para se conectar ao LindormTable.

Pré-requisitos

Antes de começar, verifique se você tem:

Java Development Kit (JDK) V1.8 ou superior

Importante

O SDK do ApsaraDB for HBase para Java não oferece suporte ao JDK 17. Se estiver executando o JDK 17, mude para uma versão compatível antes de prosseguir.

Escolha a versão do SDK

A versão do SDK segue a mesma linha de versão principal do seu cliente HBase open source existente:

Cliente HBase atual	Dependência do SDK a adicionar
HBase open source 1.x	ApsaraDB for HBase 1.x (`alihbase-client` 1.8.8)
HBase open source 2.x	ApsaraDB for HBase 2.x (`alihbase-client` 2.8.7)

Se esta for uma instalação inicial (sem cliente HBase existente), use a versão mais recente da linhagem correspondente à API HBase alvo do seu projeto. Por exemplo, se estiver desenvolvendo com as APIs do HBase 1.x e a versão mais recente do ApsaraDB for HBase for 1.8.8, instale a versão 1.8.8.

Nota

Se seu ambiente não oferecer suporte ao cliente do ApsaraDB for HBase, ou se você costuma conectar-se ao LindormTable por meio de Hive, Spark ou Flink, use um cliente HBase open source. Consulte Limitações ao usar um cliente HBase open source antes de prosseguir.

Adicione a dependência Maven

Adicione a dependência correspondente à versão do seu SDK no arquivo pom.xml.

HBase 1.x — Maven:

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

HBase 2.x — Maven:

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

Próximas etapas

Após a instalação, conecte-se ao LindormTable e inicie o desenvolvimento:

Verifique os limites da API: Antes de estabelecer a conexão, revise as restrições da API do ApsaraDB for HBase. Consulte Limites.
Conecte-se e desenvolva: Para obter parâmetros de conexão e exemplos de uso, consulte Use a API do ApsaraDB for HBase para Java no desenvolvimento de aplicações.

Importante

A API do ApsaraDB for HBase para Java não acessa tabelas SQL. Verifique o tipo da sua tabela de dados antes de conectar-se.

Limitações ao usar um cliente HBase open source

Ao optar por um cliente HBase open source em vez do SDK do ApsaraDB for HBase, observe as seguintes restrições:

Exclusivamente via VPC: A conexão com o LindormTable só é possível por meio de uma virtual private cloud (VPC). Não há suporte para conexões pela internet.
Apenas instâncias de zona única: Clientes HBase open source não conseguem conectar-se a instâncias do Lindorm implantadas em múltiplas zonas.
Impacto no desempenho: A conversão entre o protocolo HBase open source e o protocolo nativo do LindormTable pode reduzir o desempenho.
Recursos indisponíveis: Os seguintes recursos do LindormTable ficam inacessíveis: transmissão compactada, autenticação de requisições, Access Control List (ACL), rastreamento ponta a ponta, além de envio e otimização de configurações do cliente.
Requisito de versão do LindormTable: O LindormTable deve estar na versão 2.6.2.8 ou superior. Para atualizar, consulte Atualize a versão secundária do mecanismo de uma instância do Lindorm.
Faixa de versões do cliente: A versão do cliente HBase open source deve estar entre 0,98 e 2.x.

Veja também

Use o Lindorm Shell (ferramenta cliente HBase integrada ao Lindorm) para conectar-se interativamente ao LindormTable. Consulte Use o Lindorm Shell para se conectar ao LindormTable.
Execute instruções SQL em tabelas HBase criadas com a API do ApsaraDB for HBase. Consulte Use SQL para acessar uma tabela HBase.