HBase Shell 是 HBase 提供的交互式命令行工具，用户可以通过它直接与 HBase 集群进行交互，执行数据管理、表操作、集群维护等任务，以下从基础操作、表管理、数据操作、集群管理、权限控制等方面详细介绍 HBase Shell 常用命令，并通过表格形式归纳核心命令的语法与功能。
（图片来源网络，侵删）
基础操作命令
进入与退出 HBase Shell
# 进入 HBase Shell hbase shell # 退出 HBase Shell exit
查看帮助信息
# 查看所有命令帮助 help # 查看特定命令的详细帮助 help 'create'
查看服务器状态
# 显示 HBase 版本、服务器状态等信息 status # 显示详细的服务器状态（如 RegionServer 负载） status 'details'
表管理命令
创建表
# 语法：create '表名', '列族名1', '列族名2', ... # 示例：创建一个名为 'user' 的表，包含 'info' 和 'data' 两个列族 create 'user', 'info', 'data'
查看表列表
# 查看所有表 list # 查看表是否存在（返回 true/false） exists 'user' # 查看表结构（包含列族、版本数等属性） describe 'user'
修改表结构
# 禁用表（修改表前必须先禁用）
disable 'user'
# 启用表
enable 'user'
# 添加列族
alter 'user', 'new_column_family'
# 修改列族属性（如设置最大版本数为 3）
alter 'user', {NAME => 'info', VERSIONS => 3}
# 删除列族
alter 'user', 'delete' => 'new_column_family'
删除表
# 删除表前必须先禁用 disable 'user' # 删除表 drop 'user'
启用/禁用表
# 检查表是否启用 is_enabled 'user' # 检查表是否禁用 is_disabled 'user'
数据操作命令
插入/更新数据
# 语法：put '表名', '行键', '列族:列名', '值', [时间戳] # 示例：向 'user' 表插入数据，行键为 'row1'，列族 'info' 的列 'name' 值为 'Alice' put 'user', 'row1', 'info:name', 'Alice' # 插入带时间戳的数据（时间戳为可选参数，默认为当前时间） put 'user', 'row1', 'info:age', '25', 1634567890000
查询数据
# 1. 查询单行数据
get 'user', 'row1'
# 2. 查询多列数据（指定列族:列名）
get 'user', 'row1', 'info:name', 'info:age'
# 3. 查询指定版本的数据（默认返回最新版本，可指定版本数）
get 'user', 'row1', {COLUMN => 'info:name', VERSIONS => 2}
# 4. 全表扫描（扫描所有行）
scan 'user'
# 5. 条件扫描（指定行键范围、列族、时间范围等）
scan 'user', {STARTROW => 'row1', STOPROW => 'row3', COLUMN => 'info:name'}
scan 'user', {TIMERANGE => [1634567890000, 1634567990000]} # 指定时间范围
删除数据
# 1. 删除指定列的某个版本数据 delete 'user', 'row1', 'info:name', 1634567890000 # 2. 删除指定列的所有版本数据（默认删除最新版本） delete 'user', 'row1', 'info:name' # 3. 删除整行数据 deleteall 'user', 'row1'
计数器操作
# 语法：increment '表名', '行键', '列族:列名', [步长] # 示例：对 'user' 表的 'row1' 行 'info:click_count' 列执行加 1 操作 increment 'user', 'row1', 'info:click_count' # 指定步长加 5 increment 'user', 'row1', 'info:click_count', 5 # 获取计数器值 get_counter 'user', 'row1', 'info:click_count'
Region 管理
手动触发 Region 分裂
# 对指定表触发 Region 分裂 split 'user' # 对指定 Region 分裂（需指定 Region 名） split 'region_name'
手动触发 Region 合并
# 合并相邻的 Region（需指定两个 Region 的起始行键） merge_region 'region1_start_key', 'region2_start_key'
查看 Region 信息
# 查看所有 Region 的位置信息 regions # 查看指定表的 Region 分配情况 locate_region 'user'
权限控制命令
添加用户权限
# 语法：grant '用户名', '权限', '表名', '列族' # 权限包括：'read'（读）、'write'（写）、'admin'（管理）、'create'（创建）、'drop'（删除） # 示例：为用户 'test' 赋予 'user' 表的读权限 grant 'test', 'read', 'user'
查看用户权限
# 查看指定用户的权限 user_permissions 'test'
收回用户权限
# 语法：revoke '用户名', '表名', '列族' revoke 'test', 'user'
快照管理命令
创建快照
# 语法：snapshot '表名', '快照名' snapshot 'user', 'user_snapshot_20231001'
恢复快照
# 恢复前需禁用表 disable 'user' # 恢复快照到表 restore_snapshot 'user_snapshot_20231001'
删除快照
delete_snapshot 'user_snapshot_20231001'
列出所有快照
list_snapshots
核心命令速查表
| 功能分类 | 命令 | 语法示例 | 说明 |
|---|---|---|---|
| 表操作 | create | create 'user', 'info' | 创建表，指定列族 |
| list | list | 列出所有表 | |
| describe | describe 'user' | 查看表结构 | |
| alter | alter 'user', {NAME => 'info', VERSIONS => 3} | 修改表结构或列族属性 | |
| drop | disable 'user'; drop 'user' | 删除表（需先禁用） | |
| 数据操作 | put | put 'user', 'row1', 'info:name', 'Alice' | 插入/更新数据 |
| get | get 'user', 'row1' | 查询单行数据 | |
| scan | scan 'user', {STARTROW => 'row1'} | 全表扫描或条件扫描 | |
| delete | delete 'user', 'row1', 'info:name' | 删除指定列数据 | |
| deleteall | deleteall 'user', 'row1' | 删除整行数据 | |
| Region 管理 | split | split 'user' | 手动触发 Region 分裂 |
| merge_region | merge_region 'row1', 'row2' | 合并相邻 Region | |
| 权限控制 | grant | grant 'test', 'read', 'user' | 为用户授权 |
| revoke | revoke 'test', 'user' | 收回用户权限 | |
| 快照管理 | snapshot | snapshot 'user', 'user_snapshot' | 创建表快照 |
| restore_snapshot | restore_snapshot 'user_snapshot' | 恢复快照到表 |
相关问答FAQs
问题1：HBase 中如何批量插入数据？
答：HBase Shell 本身不支持直接批量插入，但可以通过循环脚本实现，使用 Shell 脚本结合 put 命令批量插入：
#!/bin/bash
for i in {1..1000}; do
echo "put 'user', 'row$i', 'info:name', 'user$i'" | hbase shell
done
推荐使用 MapReduce、Spark 或 HBase BulkLoad 工具（如 importtsv）进行高效批量数据导入，避免频繁网络开销。
问题2：如何查看 HBase 表中某个 Region 的负载情况？
答：可以通过以下步骤查看 Region 负载：
- 进入 HBase Shell，执行
status 'details'，查看每个 RegionServer 的 Region 数量、请求次数等； - 执行
catalog:'hbase:meta'查看hbase:meta表中的 Region 信息，包括 Region 起始行键、所属 RegionServer 等； - 结合 HMaster Web UI（默认地址
http://<master_ip>:16010）查看更详细的 Region 负载统计，如 Storefile 大小、MemStore 使用量等。
（图片来源网络，侵删）
