All Products
Search
Document Center

ApsaraDB for HBase:Use HBaseue Shell to access an ApsaraDB for HBase Performance-enhanced Edition instance

Last Updated:Mar 28, 2026

HBaseue Shell lets you connect to an ApsaraDB for HBase Performance-enhanced Edition instance from the command line to run DDL operations and read or write data.

HBaseue Shell supports DDL operations and data read and write operations only. Instance management commands such as balance and move are disabled.

Prerequisites

Before you begin, ensure that you have:

  • For an internal network connection: An Elastic Compute Service (ECS) instance in the same virtual private cloud (VPC) as the ApsaraDB for HBase Performance-enhanced Edition instance, with its IP address added to the instance whitelist. See Create an ECS instance and Configure a whitelist.

  • For an Internet connection: An IP address whitelist configured for the instance. See Configure a whitelist.

Connect to an instance

Step 1: Download HBaseue Shell

  1. Log on to the ApsaraDB for HBase console.

  2. On the Clusters page, find the instance and click its ID.

    Instances

  3. In the left-side navigation pane of the instance details page, click Database Connection.

    Download HBaseue Shell

  4. On the Database Connection page, click HBase Shell download.

Step 2: Configure the connection

Decompress the downloaded package, then add the following configuration to hbase-site.xml:

<configuration>
    <!-- Endpoint of your ApsaraDB for HBase instance.
         Go to the instance details page, click Database Connection,
         and find the endpoint in the Connection Information section.
         Use the public endpoint for Internet connections,
         or the VPC-facing endpoint for VPC connections. -->
    <property>
        <name>hbase.zookeeper.quorum</name>
        <value>ld-xxxx-proxy-hbaseue.hbaseue.xxx.rds.aliyuncs.com:30020</value>
    </property>
    <!-- Username for the instance. The default username is root. -->
    <property>
        <name>hbase.client.username</name>
        <value>testuser</value>
    </property>
    <!-- Password for the instance. The default password is root. -->
    <property>
        <name>hbase.client.password</name>
        <value>password</value>
    </property>
</configuration>

Replace the placeholder values with your instance information:

PlaceholderDescriptionWhere to find it
ld-xxxx-proxy-hbaseue.hbaseue.xxx.rds.aliyuncs.com:30020Instance endpointDatabase Connection page > Connection Information section
testuserInstance usernameDefault is root
passwordInstance passwordDefault is root

Step 3: Start HBaseue Shell

Run the following command to start HBaseue Shell:

bin/hbase shell