Todos os produtos
Search
Central de documentação

ApsaraDB for HBase:Conectar-se a um cluster de desempenho aprimorado com o HBase Shell

Última atualização: Jun 27, 2026

Este tópico explica como usar o HBase Shell para se conectar a uma instância do ApsaraDB for HBase Performance-enhanced Edition.

Pré-requisitos

  • Para conexões via rede privada, verifique se sua instância ECS está na mesma VPC da instância do ApsaraDB for HBase Performance-enhanced Edition. Adicione também o endereço IP da instância ECS à lista de permissões da instância do ApsaraDB for HBase.

  • Para acesso pela internet, configure uma lista de permissões. Para mais informações, consulte Configure uma lista de permissões.

Uso

Recomendamos fortemente o uso de um ambiente Linux ou macOS para se conectar ao mecanismo de coluna larga com o HBase Shell. Em ambientes Windows, podem ocorrer erros ou problemas relacionados a bibliotecas ausentes. Nesse caso, adicione as bibliotecas necessárias ao sistema conforme indicado nas mensagens de erro.

Procedimento

  1. Baixe o pacote do HBase Shell.

    1. Faça login no console do ApsaraDB for HBase.

    2. Na página Clusters, clique em ID da instância de destino para abrir a página de detalhes da instância.

    3. No painel de navegação à esquerda, clique em Database Connection.

    4. Na seção Connection Information, clique em HBase Shell download para baixar o pacote.

  2. Descompacte o pacote do HBase Shell baixado e modifique o arquivo hbase-site.xml para adicionar a seguinte configuração:

    <configuration>        
       <!-- The endpoint of the instance. You can obtain the endpoint on the Database Connection page of the console. Note the difference between a public endpoint and a private endpoint. -->        
    <property>       
         <name>hbase.zookeeper.quorum</name>        
         <value>ld-bp1utwvg3zfou****-proxy-hbase.hbase.xxx.rds.aliyuncs.com:30020</value>    
    </property>    
    <!-- Set the username and password. The default value for both is root. Modify them based on your business requirements. -->        
    <property>        
         <name>hbase.client.username</name>        
         <value>testuser</value>   
    </property>    
    <property>        
         <name>hbase.client.password</name>        
         <value>password</value>   
    </property>
    </configuration>  
  3. Execute o comando bin/hbase shell para se conectar à instância do ApsaraDB for HBase Performance-enhanced Edition.

    Nota

    Ao usar o HBase Shell para se conectar a uma instância do ApsaraDB for HBase Performance-enhanced Edition (Lindorm), apenas operações simples de DDL e leitura/gravação de dados estão disponíveis. Comandos de gerenciamento, como balance e move, estão desabilitados. Para mais informações, consulte Limitações.