一、help
1.help
显示命名的分组情况
2.help '命令名称'
查看命令的具体使用,包括命令的作用和用法。
举例:help 'list'
二、general 组(普通命令组)
命令 描述 格式
三、命名空间(namespace)
命名空间是HBase中的一个逻辑概念,用于对表进行逻辑分组,类似于关系型数据库中的数据库概念。
1.创建命名空间:
create_namespace '命名空间名称'
2.列举命名空间
list_namespace
3.获取命名空间描述
describe_namespace '命名空间名称'
4.查看命名空间下的所有表
list_namespace_tables '命名空间名称'
5.删除命名空间
drop_namespace '命名空间名称'
四、DDL组(与表相关的命令)
1. 创建表create
在创建一个表的时候,列族必须作为模式定义的一部分预先给出,而列族是支持动态扩展的,也就是列族成员可以随后按需加入,既创建表时只需要指定列族名称,不需要指定列名。
语法1:
create '表名', {NAME => '列簇名1'}, {NAME => '列簇名2'}, {NAME => '列簇名3'}注意:指定命名空间下创建表(命名空间类似于数据库,相当于指定某数据库下创建表)
create '命名空间:表名' '列簇名'语法2:
create '表名', '列族名1', '列簇名2', '列簇名3'(此种方式是上面的简写方式,但使用上面方式可以为列族指定更多的属性,如VERSIONS、TTL、BLOCKCACHE、CONFIGURATION等属性,就是下面的语法3)
语法3:
create '表名', {NAME => '列簇名1', VERSIONS => 版本号, TTL => 过期时间, BLOCKCACHE => true}
语法1示例:
create 'tbl_user', 'info', 'detail'语法3示例:
create 't1', {NAME => 'f1', VERSIONS => 1, TTL => 2592000, BLOCKCACHE => true},{NAME => 'f2',..}
2.修改(添加、删除)表结构Schema alter
2.1添加一个列簇
语法:
alter '表名', '列族名'
示例:
alter 'table1', 'cf2'2.2删除一个列簇
语法 :
alter '表名', {NAME=> '列族名', METHOD=> 'delete'}示例:
alter 'tbl_user', {NAME=> 'address', METHOD=> 'delete'}2.3修改列簇的属性
(可以修改列簇的VERSIONS、IN_MEMORY )
语法1:修改表table1的列簇cf1的版本为5
alter 'table1', NAME => 'cf1', VERSIONS => 5
语法2:修改多个列簇,修改cf2为内存,cf3版本号为5
alter 'table1', 'cf1', {NAME => 'cf2', IN_MEMORY => true}, {NAME => 'cf3', VERSIONS => 5}
也可以修改table-scope属性,例如MAX_FILESIZE, READONLY,MEMSTORE_FLUSHSIZE, DEFERRED_LOG_FLUSH等。
例如,修改region的最大大小为128MB:
alter 't1', MAX_FILESIZE => '134217728'
3.表的基本操作
3.1获取表的描述
语法:describe '表名'
3.2列举所有表(所有的命名空间下所有的表)
语法:list
3.3查看表是否存在
语法:exists
3.4启用表和禁用表
通过enable和disable来启用/禁用这个表,相应的可以通过is_enabled和is_disabled来检查表是否被禁用
(1)启用表:enable '表名'
(2)查看表是否被启用:is_enabled '表名'
(3)禁用表:disable '表名'
(4)查看表是否被禁用:is_disabled '表名'
3.4.1禁用满足正则表达式的所有表(disable_all )
-
.匹配除“\n”和"\r"之外的任何单个字符
-
*
匹配前面的子表达式任意次
# 匹配以t开头的表名
disable_all 't.*'
# 匹配指定命名空间ns下的以t开头的所有表
disable_all 'ns:t.*'
# 匹配ns命名空间下的所有表
disable_all 'ns:.*'
3.4.2启用满足正则表达式的所有表(enable_all )enable_all 't.*'
enable_all 'ns:t.*'
enable_all 'ns:.*'
3.5 修改表可以存储多个版本
语法:alter '表名',NAME=>'列簇名',VERSIONS=>版本数量
3.6 删除表
需要先禁用表,然后再删除表,启用的表是不允许删除的
语法1:删除单张表
disable '表名'
drop '表名'
语法2:删除满足正则表达式的所有表
drop_all 't.*' //删除t开头的所有表(默认命名空间下)
drop_all 'ns:t.*' //删除ns命名空间下t开头的所有表
drop_all 'ns:.*' //删除ns命名空间下的所有表
3.7 获取某个表赋值给一个变量(get_table)
通过 var = get_table ‘表名’ 赋值给一个变量对象,然后对象.来调用,就像面向对象编程一样,通过对象.方法来调用,这种方式在操作某个表时就不必每次列举表名了。
3.8 获取rowKey所在的区( locate_region)
语法:locate_region '表名', '行键'
3.9 显示hbase所支持的所有过滤器(show_filters)
过滤器用于get和scan命令中作为筛选数据的条件,类型关系型数据库中的where的作用
五、DML(数据操作组)
1.插入或者修改数据put
语法1:当列族中只有一个列时'列族名:列名'使用'列族名'
put '表名', '行键', '列族名', '列值'语法2:
put '表名', '行键', '列族名:列名', '列值'# 示例
# 创建表
create 'tal_users', 'info', 'detail', 'address'# 插入第一行数据
put 'tal_users', 'rk1001', 'info:id', '1'
put 'tal_users', 'rk1001', 'info:name', '张三'
put 'tal_users', 'rk1001', 'info:age', '28'
put 'tal_users', 'rk1001', 'detail:birthday', '1990-06-26'
put 'tal_users', 'rk1001', 'detail:email', 'abc@163.com'
put 'tal_users', 'rk1001', 'detail:create_time', '2019-03-04 14:26:10'
put 'tal_users', 'rk1001', 'address', '上海市'#插入第二行数据
put 'tal_users', 'rk1002', 'info:id', '2'
put 'tal_users', 'rk1002', 'info:name', '李四'
put 'tal_users', 'rk1002', 'info:age', '27'
put 'tal_users', 'rk1002', 'detail:birthday', '1990-06-27'
put 'tal_users', 'rk1002', 'detail:email', 'xxx@gmail.com'
put 'tal_users', 'rk1002', 'detail:create_time', '2019-03-05 14:26:10'
put 'tal_users', 'rk1002', 'address', '北京市'
#插入第三行数据
put 'tal_users', 'rk1003', 'info:id', '3'
put 'tal_users', 'rk1003', 'info:name', '王五'
put 'tal_users', 'rk1003', 'info:age', '26'
put 'tal_users', 'rk1003', 'detail:birthday', '1990-06-28'
put 'tal_users', 'rk1003', 'detail:email', 'xyz@qq.com'
put 'tal_users', 'rk1003', 'detail:create_time', '2019-03-06 14:26:10'put 'tal_users', 'rk1003', 'address', '杭州市'
将内存中的数据刷新到表中:flush 'tal_users'
这样每个列簇下都有数据
注意:每次flush都会将内存中的数据书刷新到表中,但是会新生成一个小文件来存放此数据,因此我们可以使用major_compact '表名'来合并这些小文件
2.全表扫描scan
(效果类似于sql语句中select * from xxx)
2.2查询完整数据
语法1:scan '表名'
以1中插入的数据表为例:
scan 'tal_users'
注意:Table中的所有行都是按照row key的字典排序的
2.3 查询某个列簇数据
语法:
scan '表名', {COLUMN=>'列族名'}示例:
scan 'tal_users',{COLUMN=>'info'}
2.4 查询某个列簇下的某个列数据
语法:
scan '表名', {COLUMN=>'列族名:列名'}示例
scan 'tal_users', {COLUMN=>'info:age'}
3.获取数据
语法1:获取一行数据
get '表名', '行键'
示例: get 'tal_users','rk1001'
语法2:获取一行数据中某个列簇的数据
get '表名','行键','列簇名'
示例:get 'tal_users','rk1001','detail' 或get 'tal_users', 'rk1002',{COLUMN =>'detail'}
语法3:获取一行数据中多个列簇的数据
get '表名','行键',['列簇名1','列簇名2'】
示例:
get 'tal_users','rk1001',['info','detail']
语法4:获取某个单元格的数据
get '表名','行键','列簇名:列名'
示例:get 'tal_users','rk1002','detail:birthday'
语法5:获取某个单元格多个版本的值,默认是按照时间戳降序排序
get '表名', '行键', {COLUMN => '列簇名', VERSIONS => 版本数}
4.删除数据
4.1删除某个列簇中的某个列(delete)
语法:delete '表名', '行键', '列族名:列名'
4.2删除某行数据(deleteall)
语法:deleteall '表名', '行键'
5.清空表数据
语法:truncate '表名'
6.自增与计数器
6.1自增(incr)
语法
incr '表名', '行键', '列族:列名', 步长值incr 'tal_users','rk1004','info:name',1
# 注意:incr 是对不存在的行键操作,如果行键已经存在会报错,如果使用put修改了incr的值再使用incr也会报错
6.2计数器(get_counter )
# 创建表(点击量:日、周、月)
create 'counters', 'daily', 'weekly', 'monthly'
incr 'counters', '20240415', 'daily:hits', 1
incr 'counters', '20110101', 'daily:hits', 1统计表有多少行(统计的是行键的个数)
count '表名'
获取数目
get_counter 'counters', '20110101', 'daily:hits'
7.修饰词过滤
7.1 COLUMNS(与列簇列名相关)
语法:scan '表名', {COLUMNS => [ '列族名1:列名1', '列族名1:列名2', ...]}
示例:scan 'tal_users',{COLUMNS=> ['info:name','info:id']}
7.2TIMESTAMP( 指定时间戳)
语法:scan '表名',{TIMERANGE=>[timestamp1, timestamp2]}
注意:区间取得值为[ ,),右边的值取不到
7.3 VERSIONS(版本号)
默认情况下一个列只能存储一个数据,后面如果修改数据就会将原来的覆盖掉,可以通过指定VERSIONS使HBase一列能存储多个值。
示例:
create 'tbl_test', 'columnFamily1'
describe 'tbl_test'# 修改列族版本号
alter 'tbl_test', { NAME=>'columnFamily1', VERSIONS=>3 }put 'tbl_test', 'rowKey1', 'columnFamily1:column1', 'value1'
put 'tbl_test', 'rowKey1', 'columnFamily1:column1', 'value2'
put 'tbl_test', 'rowKey1', 'columnFamily1:column1', 'value3'(1)默认返回最新的一条数据
get 'tbl_test','rowKey1','columnFamily1:column1'(2)返回2个
get 'tbl_test','rowKey1',{COLUMN=>'columnFamily1:column1', VERSIONS=>2}
(3)返回3个
get 'tbl_test','rowKey1',{COLUMN=>'columnFamily1:column1', VERSIONS=>3}
7.4 STARTROW
ROWKEY起始行。会先根据这个key定位到region,再向后扫描
语法:scan '表名', { STARTROW => '行键名'}
示例:
scan 'tal_users', { STARTROW => 'rk1003'}
7.5 STOPROW
截止到STOPROW行之前的数据,不包括STOPROW这行数据
语法:scan '表名', { STOPROW=> '行键名'}
示例:
scan 'tal_users', { STOPROW=> 'rk1003'}
将 STARTROW与STOPROW结合使用:左闭右开
scan 'tal_users', { STARTROW=>'rk1001',STOPROW=> 'rk1003'}
7.6 LIMIT
语法1:返回限制的行数(从前往后)
scan '表名', { LIMIT => 行数}
语法2:返回限制的行数(从后往前)
scan '表名',{LIMIT=>行数,REVERSED=>true}
六、FILTER条件过滤器
1、ValueFilter 值过滤器
语法1:binary (等于某个值)
scan '表名', FILTER=>"ValueFilter(=,'binary:列值')"示例:
scan 'tal_users',FILTER=>"ValueFilter(=,'binary:26')"
语法2:substring(包含某个值)
scan '表名', FILTER=>"ValueFilter(=,'substring:列值')"示例:
scan 'tal_users',FILTER=>"ValueFilter(=,'substring:2019')"
啊
2、ColumnPrefixFilter 列名前缀过滤器
语法:
scan '表名', FILTER=>"ColumnPrefixFilter('列名前缀')"示例:
scan 'tal_users',FILTER=>"ColumnPrefixFilter('a')"
七、与region有关的命令
1.查看表的所有region
list_regions '表名'
2.强制将表切分出来一个region
split '表名','行键'
示例:split 'tal_users','rk1003'
切分前:
切分后:
注意:此时切分后的形成的两个region并不是在同一台机器上,而是一个region在node1,一个在node2,这是因为底层中Hmaster对RegionServer上的region作负载均衡才导致这个现象
3. 查看某一行在哪个region中
语法: locate_region '表名','行键'
4.查看region中的某列簇数据
语法:hbase hfile -p -f 'hdfs中存放列簇数据的目录'
注意:不是在客户端使用此命令