HBase shell命令大全有哪些常用命令？

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

核心命令速查表

相关问答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 负载：

1. 进入 HBase Shell，执行 status 'details'，查看每个 RegionServer 的 Region 数量、请求次数等；
2. 执行 catalog:'hbase:meta' 查看 hbase:meta 表中的 Region 信息，包括 Region 起始行键、所属 RegionServer 等；
3. 结合 HMaster Web UI（默认地址 http://<master_ip>:16010）查看更详细的 Region 负载统计，如 Storefile 大小、MemStore 使用量等。