文档中心

表格数据库 HBase 版

连接实例

使用 HBase Shell 连接实例

使用 HBase Shell 连接实例

本文介绍如何使用 HBase Shell 工具连接 HBase 实例。

前提条件

如需通过私网地址访问 HBase 实例，需同时满足如下要求：

已购 ECS 服务器与 HBase 实例在相同私有网络 VPC 下。ECS 服务器的购买方法，请参见购买云服务器。

已将 ECS 服务器的 IP 地址添加至 HBase 中的白名单中。白名单设置方法，请参见编辑白名单。

HBase Shell 所在机器的 IP 地址和端口已包含在 ECS 服务器的安全组出方向规则中。关于安全组和的 HBase 各组件对应的端口号详情信息请参见查看/修改安全组访问规则和创建白名单。

如需通过公网地址访问 HBase 实例，需开启公网访问，并确保运行 Java 工具的设备 IP 地址已加入 HBase 实例的白名单中。操作详情请请参见开启公网访问和编辑白名单。

已在 ECS 实例或本地设备上安装 Java 环境，建议使用 JDK 8 版本。更多详情，请参见 Java Downloads。

操作步骤

获取 HBase 实例的 ZK 连接地址。具体操作步骤，请参见查看连接地址。

下载 HBase Shell 工具包。

说明

根据步骤 1 的方法进入目标 HBase 实例的连接管理页签，在页面右下方单击 HBase Shell 下载。

解压 HBase Shell 工具包，并修改 hbase-2.x/conf/hbase-site.xml 文件中的配置。

# 解压 HBase Shell 工具包
tar -zxvf hbase-shell-2.x.tar.gz
# 编辑 hbase-site.xml 文件
vim hbase-2.x/conf/hbase-site.xml

说明

您需要修改代码中的如下信息：

用步骤 1 中获取的 ZK 地址替换代码中的 ${zkEndpoint}:${port}。

用目标 HBase 实例 ID 替换代码中的 ${instanceId}。您可以在 HBase 控制台的实例列表页找到并复制目标实例 ID。

使用公网地址访问 HBase 实例时，需要配置 zookeeper.znode.master 和 zookeeper.znode.metaserver 。

使用 ZK 私网连接地址访问实例
使用 ZK 公网连接地址访问实例

<configuration>
<property>
<name>hbase.zookeeper.quorum</name>
<value>${zkEndpoint}:${port}</value>
</property>
<property>
<name>zookeeper.znode.parent</name>
<value>/hbase/${instanceId}</value>
</property>
<property>
<name>zookeeper.znode.acl.parent</name>
<value>/hbase/${instanceId}</value>
</property>
</configuration>

访问目标 HBase 实例。在 hbase-2.x 目录下，执行命令 bin/hbase shell 命令即可访问实例。

说明

通过 HBase Shell 工具连接 HBase 实例后，您可以使用 Shell 命令进行建表、读写等操作。详细操作步骤，请参见如何使用 HBase Shell。

最近更新时间：2026.09.08 11:46:17

这个页面对您有帮助吗？

有用

有用

无用

无用