HBase Shell工具操作HBase

HBase Shell工具操作HBase

原创  2015年11月24日 18:30:30

• 标签：
• shell /
• hbase /
• ruby /
• 安全

• 3285

HBase的shell工具是常用的工具，运维过程的DDL和DML都会通过此进行，其具体实现是用Ruby语言编写的，并且使用了JRuby解释器。该工具模式有两种常用的模式：交互模式和命令批处理模式。交互模式用于随机访问，而命令批处理模式通过使用shell编程来批量、流程化处理访问命令，常用于HBase集群运维和监控中的定时执行命令。

1，命令分类

选择一台HBase集群的节点（最好是客户端节点），进入HBase安装目录后执行bin/hbase shell，进入HBase shell交互模式，通过执行help命令，将输出一系列帮助信息如下：

COMMAND GROUPS：

Group name:general

Commands: status,version

......

从输出来看，shell的所有命令分为6组：常规（general）、DLL、DML、工具（tools)、复制（Replication）和安全（Security）。

2，常规命令：status：返回几圈状态信息；version：返回集群的HBase版本信息，其中第一个是版本号，第二部分是版本修订号，第三部分是编译HBase的时间。

3，DDL命令：即数据定义语言命令，包含的命令非常丰富，用于管理表相关的操作，包括常见表、修改表、上线和下线表、删除表、罗列表等操作，详细如下表所示：

命令	命令含义	命令使用实例
alter	修改表的列族的描述属性	alter 't1'，NAME =>'f1'，VERSIONS=>5
alter_async	异步修改聊的列族的描述属性，并不需要等待所有Region都完成操作。用法与alter命令相同	alter_async 't1'，NAME=>'f1',VERSIONS=>5
alter_status	获取alter命令的状态，会标注已经有多少Region更改了schema。命令的参数是表名	alter_status 't1'
create	创建表	create 't1',{NAME=>'f1',VERSIONS=>5} create 't1','f1','f2','f3'
describe	创建表的元数据信息和是否可用的状态	describe 't1'
disable	下线某个表	disable 't1'
disable_all	下线所有匹配正则表达式的表	disable_all 't.*'
drop	删除某个表	drop 't1'
drop_all	删除所有匹配正则表达式的表	drop_all 't.*'
enable	上线某个表	enable 't1'
enable_all	上线所有匹配正则表达式的表	enable_all  't.*'
exists	判断某个表是否存在	exists 't1'
is_disenabled	判断某个表是否下线	is_disabled 't1'
is_enabled	判断某个表是否在线	is_enabled 't1'
show_filters	查看所支持的所有过滤器的名称	show_filters
list	罗列所有表	list

4，DML命令：即数据操作语言命令，包含的命令非常丰富，用于数据的写入、删除、修改你、查询、清空等操作，这些命令的详细解决和使用示例如表所示：

count	统计表的总行数	count ‘t1' count 't1',INTERVAL => 100000 count 't1',CACHE => 100 count 't1',INTERVAL => 10,CACHE=>10
delete	删除一个单元格	delete ’t1','r1','c1',ts1
delteall	删除一行或者一列	deleteall 't1','r1' deleteall 't1','r1','c1' deleteall 't1','r1','c1',ts1
get	单行读	get 't1','r1' get 't1','r1'{TIMERANGE => [ts1,ts2]} get 't1','r1',{COLUMN =>"c1'} get 't1','r1',{COLUMN =>[c1,c2,c3]} get 't1','r1',{COLUMN =>'c1',TIMESTAMP =>ts1} get 't1','r1',{COLUMN =>'c1',TIMERANGE=> [ts1,ts2],VERSION=4} get 't1','r1',{COLUMN =>'c1',TIMESTAMP => ts1, VERSION =>4} get 't1','r1',{FILTER => "ValueFilter(=,'binary:abc')"} get 't1','r1','c2' get 't1','r1','c1','c2' get 't1','r1',['c1','c2']
get_counter	读取计数器	get_counter 't1','r1','c1'
incr	自增写入	incr 't1','r1','c1' incr 't1','r1','c1',1
put	数据 写入	put 't1','r1','c1','value',ts1
scan	扫描读	scan '.META.' scan '.META',{COLUMNS => 'info:regioninfo'} scan 't1',{COLUMNS => [c1,c2],LIMIT =>10, STARTROW => 'xyz'} scan 't1',{COLUMNS => ' c1',TIMERANGE =>[1303668804,1303668904]} scan 't1',{FILTER => "(PrefixaFilter('row2') AND (QualifierFilter(>=,'binary:xyz')))AND (TimestampsFilter(123,456))"}
truncate	清空表	truncate 't1'

5，tool命令提供了一些工具命令，组名称为Tools，这些命令多用于HBase集群的管理与调优。这些命令涵盖合并、分裂、负载均衡、日志回滚、Region分配和移动以及zookeeper信息查看等方面。每种命令的手捧玫瑰方法有多种，适用于不同的场景。例如合并命令compact，可以合并一张表、一个Region的某个列族，或一张表的某个列族。

命令	命令含义	命令使用实例
assign	分配Region	assign ‘Region1’
balance_switch	启用或关闭负载均衡器，返回结果是当前均衡器状态	balance_switch true balance_swich false
balancer	触发集群负载均衡器。如果成果运行则返回TRUE，很可能将所有Region重新分配。 如果FALSE，说明某些Region在rit状态，不会执行该命令	balancer
close_region	关闭某个Region	close_region 'REGIONNAME' close_region 'REGUIBBANE','SERVER_NAME'
compact	合并表或者Region	compact 't1' compact 'r1','c1' compact 't1,'c1'
flush	flush表或Region	flush 'TABLENAME' flush 'REGIONNAME'
hlog_roll	HLog日志回滚，参数是regionserver的名字	hlog_roll 'regionName'
major_compact	大合并表或Region	major_compact 't1' major_compact 'r1','c1' major_compact 't1','c1'
move	移动Region。如果没有目标regionserver，则随机选择一个节点	move 'ENCODED_REGIONNAME' move 'ENCODED_REGIONNAME','SERVER_NAME'
split	分裂表或Region	split ‘tablename' split 'tablename' # format: 'tablename,startKey,id' split 'tablename','splitKey' split 'regionname','splitKey'
unassign	解除某个指定的Region	unassign 'REGIONNAME' usassign 'REGIONNAME',true
zk_dump	打印输出zookeeper的信息，包括HBase主节点，regionserver状态，以及zookeeper节点统计状态	zk_dump

6,复制命令用于HBase高级特性——复制的管理，可以添加、删除、启动和停止复制功能相关操作，但是因为HBase复制特性在0.94.*版本并不成熟，所以这里不展开讲解命令细节。

add_peer	添加对等集群，需要指定对等集群的ID、主机名、端口号和zookeeper的根路径	add_peer '1',"server1.cie.com:2181:/hbase" add_peer '2',"zk1,zk2,zk3:2181:/hbase-prod"
disable_peer	停止到特定集群的复制流，但仍然保持对新改动的跟踪。参数是对等集群的ID	disable_peer '1'
enable_peer	启用到对等集群的复制，从上次关闭的位置继续复制，参数是对等参数的ID	enable_peer '1'
list_peers	罗列所有正在复制的对等集群	list_peers
remove_peer	停止某个复制流，并且山吹其对应的元数据信息。参数是对等集群的ID	remove_peer '1'
start_replication	重启所有复制流，只用在负载达到临界的情况下	start_replication
stop_replication	关闭所有复制流，只用在负载达到临界的情况下

7，安全命令属于DCL（Data Control Language，数据控制语言）的范畴，HBase shell提供了三种安全命令：grant、revoke和user_permission。这三种命令并不是直接执行如表5-5所示的使用实例就可以使用，还需要两个前提条件：使用附带security的HBase版本和配置完成Kerberos安全认证。

grant	赋予用户特定的权限，权限集合是RWXCA：read，write，exec，create，admin	grant 'bobsmith','RWXCA' grant 'bobsmith','RW','t1','f1','col1'
revoke	撤销用户的特点权限	revoke ’bobsmith' revoke 'bobsmith','t1','f1','col1'
user_permission	显示某用户的所有权限，如果加上参数——表名，则表示该用户在该表上的所有权限	user_permission user_permission 'table1'