hbase提供了一個shell的終端給用戶交互。使用命令hbaseshell進入命令界面。通過執行 help可以看到命令的幫助信息。
以網上的一個學生成績表的例子來演示hbase的用法。
|
name |
grad |
course |
|
|
math |
art |
||
|
Tom |
5 |
97 |
87 |
|
Jim |
4 |
89 |
80 |
這裏grad對於表來說是一個只有它自己的列族,course對於表來說是一個有兩個列的列族,這個列族由兩個列組成math和art,當然我們可以根據我們的需要在course中建立更多的列族,如computer,physics等相應的列添加入course列族。
(1)建立一個表scores，有兩個列族grad和courese
hbase(main):001:0> create'scores','grade', 'course'
可以使用list命令來查看當前HBase裏有哪些表。使用describe命令來查看錶結構。（記得所有的表明、列名都需要加上引號）
(2)按設計的表結構插入值：
put'scores','Tom','grade:','5'
put 'scores','Tom','course:math','97'
put 'scores','Tom','course:art','87'
put 'scores','Jim','grade','4'
put 'scores','Jim','course:math','89'
put 'scores','Jim','course:art','80'
這樣表結構就起來了，其實比較自由，列族裏邊可以自由添加子列很方便。如果列族下沒有子列，加不加冒號都是可以的。
|
put命令比較簡單，只有這一種用法： hbase> put 't1', 'r1', 'c1', 'value', ts1 t1指表名，r1指行鍵名，c1指列名，value指單元格值。ts1指時間戳，一般都省略掉了。 |
(3)根據鍵值查詢數據
get 'scores','Jim'
get 'scores','Jim','grade'
get 'scores','Jim','course' （列族有多列的話要用scan獲取所有記錄【scan 'scores',{COLUMNS => 'course'}】，用get只得到最新加入列族的一條記錄）
get 'scores','Jim','course:math' （這樣可以）
可能你就發現規律了，HBase的shell操作，一個大概順序就是操作關鍵詞後跟表名，行名，列名這樣的一個順序，如果有其他條件再用花括號加上。
get有用法如下：
hbase> get 't1', 'r1'
hbase> get 't1', 'r1', {TIMERANGE => [ts1, ts2]}
hbase> get 't1', 'r1', {COLUMN => 'c1'}
hbase> get 't1', 'r1', {COLUMN => ['c1', 'c2', 'c3']}
hbase> get 't1', 'r1', {COLUMN => 'c1', TIMESTAMP => ts1}
hbase> get 't1', 'r1', {COLUMN => 'c1', TIMERANGE => [ts1, ts2],VERSIONS => 4}
hbase> get 't1', 'r1', {COLUMN => 'c1', TIMESTAMP => ts1, VERSIONS=> 4}
hbase> get 't1', 'r1', 'c1'
hbase> get 't1', 'r1', 'c1', 'c2'
hbase> get 't1', 'r1', ['c1', 'c2']
(4)掃描所有數據
scan 'scores'
也可以指定一些修飾詞：TIMERANGE,FILTER, LIMIT, STARTROW, STOPROW, TIMESTAMP, MAXLENGTH,or COLUMNS。沒任何修飾詞，就是上邊例句，就會顯示所有數據行。
例句如下：
hbase> scan '.META.'
hbase> scan '.META.', {COLUMNS => 'info:regioninfo'}
hbase> scan 't1', {COLUMNS => ['c1', 'c2'], LIMIT => 10, STARTROW=> 'xyz'}
hbase> scan 't1', {COLUMNS => 'c1', TIMERANGE => [1303668804,1303668904]}
hbase> scan 't1', {FILTER => "(PrefixFilter ('row2') AND (QualifierFilter(>=, 'binary:xyz'))) AND (TimestampsFilter ( 123, 456))"}
hbase> scan 't1', {FILTER =>org.apache.hadoop.hbase.filter.ColumnPaginationFilter.new(1, 0)}
過濾器filter有兩種方法指出：
a. Using a filterString - more information on this is available in the
Filter Language document attached to the HBASE-4176 JIRA
b. Using the entire package name of the filter.
還有一個CACHE_BLOCKS修飾詞，開關scan的緩存的，默認是開啓的（CACHE_BLOCKS=>true），可以選擇關閉（CACHE_BLOCKS=>false）。
(5)刪除指定數據
delete 'scores','Jim','grade'
delete 'scores','Jim'
刪除數據命令也沒太多變化，只有一個：
hbase> delete 't1', 'r1','c1', ts1
另外有一個deleteall命令，可以進行整行的範圍的刪除操作，慎用！
如果需要進行全表刪除操作，就使用truncate命令，其實沒有直接的全表刪除命令，這個命令也是disable，drop，create三個命令組合出來的。
(6)修改表結構
disable 'scores'
alter 'scores',NAME=>'info'
enable 'scores'
alter命令使用如下（如果無法成功的版本，需要先通用表disable）：
a、改變或添加一個列族：
hbase> alter 't1', NAME=> 'f1', VERSIONS => 5
b、刪除一個列族：
hbase> alter 't1', NAME=> 'f1', METHOD => 'delete'
hbase> alter 't1', 'delete' => 'f1'
c、也可以修改表屬性如MAX_FILESIZE
MEMSTORE_FLUSHSIZE, READONLY,和 DEFERRED_LOG_FLUSH：
hbase> alter 't1', METHOD => 'table_att', MAX_FILESIZE => '134217728'
d、可以添加一個表協同處理器
hbase> alter 't1', METHOD=> 'table_att', 'coprocessor'=>'hdfs:///foo.jar|com.foo.FooRegionObserver|1001|arg1=1,arg2=2'
一個表上可以配置多個協同處理器，一個序列會自動增長進行標識。加載協同處理器（可以說是過濾程序）需要符合以下規則：
[coprocessor jar filelocation] | class name | [priority] | [arguments]
e、移除coprocessor如下：
hbase> alter 't1', METHOD=> 'table_att_unset', NAME => 'MAX_FILESIZE'
hbase> alter 't1', METHOD => 'table_att_unset', NAME =>'coprocessor$1'
f、可以一次執行多個alter命令：
hbase> alter 't1', {NAME=> 'f1'}, {NAME => 'f2', METHOD => 'delete'}
(7)統計行數：
hbase> count 't1'
hbase> count 't1', INTERVAL => 100000
hbase> count 't1', CACHE => 1000
hbase> count 't1', INTERVAL => 10, CACHE => 1000
count一般會比較耗時，使用mapreduce進行統計，統計結果會緩存，默認是10行。統計間隔默認的是1000行（INTERVAL）。
(8)disable 和 enable 操作
很多操作需要先暫停表的可用性，比如上邊說的alter操作，刪除表也需要這個操作。disable_all和enable_all能夠操作更多的表。
(9)表的刪除
先停止表的可使用性，然後執行刪除命令。
drop 't1'
以上是一些常用命令詳解，具體的所有hbase的shell命令如下，分了幾個命令羣，看英文是可以看出大概用處的，詳細的用法使用help"cmd" 進行了解。
COMMAND GROUPS:
Group name:general
Commands: status,version
Group name: ddl
Commands: alter,alter_async, alter_status, create, describe, disable, disable_all, drop,drop_all,
enable, enable_all, exists, is_disabled, is_enabled,list, show_filters
Group name: dml
Commands: count,delete, deleteall, get, get_counter, incr, put, scan, truncate
Group name: tools
Commands: assign,balance_switch, balancer, close_region, compact, flush, hlog_roll,major_compact,
move, split, unassign, zk_dump
Group name:replication
Commands:add_peer, disable_peer, enable_peer, list_peers, remove_peer,start_replication,
stop_replication
Group name:security
Commands: grant,revoke, user_permission
4. hbase shell腳本
既然是shell命令，當然也可以把所有的hbaseshell命令寫入到一個文件內，想linux
shell腳本程序那樣去順序的執行所有命令。如同寫linuxshell，把所有hbaseshell命令書寫在一個文件內，然後執行如下命令即可：
$ hbase shell test.hbaseshell
方便好用。