在配置好 HBase 环境变量后，终端执行：

hbase shell

即可进入交互式命令行。按 exit 退出，使用 help '命令名' 查看具体说明。

通用管理命令

命令	说明	用法示例
status	查看集群健康状态	status
version	显示 HBase 版本	version
whoami	显示当前用户与组	whoami
table_help	列出表操作相关帮助	table_help
list	列出所有表	list
exists	判断表是否存在	exists 'staff'

DDL 操作

1. 创建表 create

HBase 建表时只需指定列簇（Column Family），无需指定具体列。完整写法可配置版本数、TTL 等属性。

# 简写
create 'staff', 'basic', 'extra'

# 完整写法
create 'staff', {NAME => 'basic'}, {NAME => 'extra'}

# 指定版本数与过期时间
create 'logs', {NAME => 'event', VERSIONS => 4, TTL => 86400, BLOCKCACHE => true}

2. 修改表结构 alter

# 新增列簇
alter 'staff', 'contact'

# 删除列簇
alter 'staff', {NAME => 'contact', METHOD => 'delete'}

# 修改属性
alter 'staff', {NAME => 'basic', VERSIONS => 5, IN_MEMORY => true}

3. 查看表信息 describe

describe 'staff'

4. 启用/禁用与删除

删除表前必须先禁用。

disable 'staff'
is_disabled 'staff'

drop 'staff'

按正则批量禁用、启用、删除：

disable_all 's.*'
enable_all 's.*'
drop_all 's.*'

5. 清空表 truncate

其内部流程为：禁用表 → 删除表 → 重新创建表。

truncate 'staff'

Namespace 管理

HBase 使用命名空间替代数据库概念。

# 创建
create_namespace 'company'

# 查看
list_namespace
describe_namespace 'company'

# 查看命名空间下所有表
list_namespace_tables 'company'

# 删除
drop_namespace 'company'

DML 操作

1. 插入或更新数据 put

create 'employee', 'profile', 'salary'

put 'employee', 'e001', 'profile:name', 'Alice'
put 'employee', 'e001', 'profile:age', '28'
put 'employee', 'e001', 'salary:base', '15000'

put 'employee', 'e002', 'profile:name', 'Bob'
put 'employee', 'e002', 'profile:age', '32'
put 'employee', 'e002', 'salary:base', '18000'

2. 全表扫描 scan

# 全表扫描
scan 'employee'

# 扫描指定列簇
scan 'employee', {COLUMN => 'profile'}

# 扫描指定列
scan 'employee', {COLUMN => 'profile:age'}

# 多列查询
scan 'employee', {COLUMNS => ['profile:name', 'salary:base']}

3. 单行查询 get

# 查询一行
get 'employee', 'e001'

# 查询某列簇
get 'employee', 'e001', 'profile'

# 查询多列
get 'employee', 'e001', {COLUMN => ['profile:name', 'salary:base']}

# 按版本数查询
get 'employee', 'e001', {COLUMN => 'profile:age', VERSIONS => 3}

4. 删除数据

# 删除某个单元格
delete 'employee', 'e001', 'profile:age'

# 删除整行
deleteall 'employee', 'e001'

5. 计数器 incr / get_counter

create 'counters', 'daily'

# 点击量自增
incr 'counters', '20240101', 'daily:clicks', 1
incr 'counters', '20240101', 'daily:clicks', 1

# 查看计数器值
get_counter 'counters', '20240101', 'daily:clicks'

扫描修饰与过滤

常用修饰词

# 指定时间范围
scan 'employee', {TIMERANGE => [1704067200000, 1706745600000]}

# 指定起始行（包含）
scan 'employee', {STARTROW => 'e001'}

# 指定结束行（不包含）
scan 'employee', {STOPROW => 'e003'}

# 限制返回行数
scan 'employee', {LIMIT => 2}

条件过滤器

# 值等于指定内容
scan 'employee', FILTER => "ValueFilter(=, 'binary:Alice')"

# 值包含指定子串
scan 'employee', FILTER => "ValueFilter(=, 'substring:Al')"

# 列名前缀过滤
scan 'employee', FILTER => "ColumnPrefixFilter('na')"

# 组合过滤
scan 'employee', FILTER => "ColumnPrefixFilter('na') AND ValueFilter(=, 'binary:Alice')"