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.
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.
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.xmldo 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.xmldo projeto Maven:<dependency> <groupId>com.aliyun.hbase</groupId> <artifactId>alihbase-client</artifactId> <version>2.8.11</version> </dependency>
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
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
Use o Lindorm Shell, ferramenta de cliente HBase fornecida pelo Lindorm, para conectar-se ao LindormTable. Para mais informações, consulte Connect to LindormTable using Lindorm Shell.
Execute instruções SQL para acessar tabelas HBase criadas por meio da API do ApsaraDB for HBase. Para mais informações, consulte Use SQL to access an HBase table.