HBase shell的基本用法
hbase提供了一個shell的終端給使用者互動。使用命令hbase shell進入命令介面。通過執行 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:','89′ put ‘scores','Jim','course:','80′
這樣表結構就起來了,其實比較自由,列族裡邊可以自由添加子列很方便。如果列族下沒有子列,加不加冒號都是可以的。
put命令比較簡單,只有這一種用法:
hbase> put ‘t1′, ‘r1′, ‘c1′, ‘value', ts1
t1指表名,r1指行鍵名,c1指列名,value指儲存格值。ts1指時間戳記,一般都省略掉了。
(3)根據索引值查詢資料
get ‘scores','Jim' get ‘scores','Jim','grade'
可能你就發現規律了,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 file location] | 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