HBase 为用户提供了一个非常方便的使用方式, 我们称之为“HBase Shell”。
HBase Shell 提供了大多数的 HBase 命令, 通过 HBase Shell 用户可以方便地创建、删除及修改表, 还可以向表中添加数据、列出表中的相关信息等。
在启动 HBase 之后,用户可以通过下面的命令进入 HBase Shell 之中,命令如下所示:
[hadoop@hadoopmaster ~]$ hbase shell HBase Shell; enter 'help<RETURN>' for list of supported commands. Type "exit<RETURN>" to leave the HBase Shell Version 0.94.2, r1395367, Sun Oct 7 19:11:01 UTC 2012 hbase(main):001:0> |
具体的 HBase Shell 命令如下表 1.1-1 所示:
下面我们将以“一个学生成绩表”的例子来详细介绍常用的 HBase 命令及其使用方法。
这里 grad 对于表来说是一个列,course 对于表来说是一个列族,这个列族由三个列组成 china、math 和 english,当然我们可以根据我们的需要在 course 中建立更多的列族,如computer,physics 等相应的列添加入 course 列族。(备注:列族下面的列也是可以没有名字的。)
1. create 命令(新建一张表)
创建一个具有两个列族“grad”和“course”的表“scores”。其中表名、行和列都要用单引号括起来,并以逗号隔开。
hbase(main):001:0> create 'scores','name','grad','course'
0 row(s) in 2.2190 seconds
hbase(main):002:0>
|
2. list 命令(显示数据库中的表)
查看当前 HBase 中具有哪些表。
hbase(main):002:0> list
TABLE
scores
wordcount
wordcount1
3 row(s) in 0.1350 seconds
hbase(main):003:0>
|
3. describe 命令(描述表结构)
查看表“scores”的构造。
hbase(main):004:0> describe 'scores'
DESCRIPTION ENABLED
{NAME => 'scores', FAMILIES => [{NAME => 'course', ENCODE_ON_DISK => 'true', BLOOMFIL true
TER => 'NONE', VERSIONS => '3', IN_MEMORY => 'false', KEEP_DELETED_CELLS => 'false',
DATA_BLOCK_ENCODING => 'NONE', TTL => '2147483647', COMPRESSION => 'NONE', MIN_VERSIO
NS => '0', BLOCKCACHE => 'true', BLOCKSIZE => '65536', REPLICATION_SCOPE => '0'}, {NA
ME => 'grad', ENCODE_ON_DISK => 'true', BLOOMFILTER => 'NONE', VERSIONS => '3', IN_ME
MORY => 'false', KEEP_DELETED_CELLS => 'false', DATA_BLOCK_ENCODING => 'NONE', TTL =>
'2147483647', COMPRESSION => 'NONE', MIN_VERSIONS => '0', BLOCKCACHE => 'true', BLOC
KSIZE => '65536', REPLICATION_SCOPE => '0'}, {NAME => 'name', ENCODE_ON_DISK => 'true
', BLOOMFILTER => 'NONE', VERSIONS => '3', IN_MEMORY => 'false', KEEP_DELETED_CELLS =
> 'false', DATA_BLOCK_ENCODING => 'NONE', TTL => '2147483647', COMPRESSION => 'NONE',
MIN_VERSIONS => '0', BLOCKCACHE => 'true', BLOCKSIZE => '65536', REPLICATION_SCOPE =
> '0'}]}
1 row(s) in 0.0800 seconds
hbase(main):005:0>
|
4. put 命令(插入一条数据)
使用 put 命令向表中插入数据,参数分别为表名、行名、列名和值,其中列名前需要列族最为前缀,时间戳由系统自动生成。
格式: put 表名,行名,列名([列族:列名]),值
例子:
a. 加入一行数据,行名称为“xiapi”,列族“grad”的列名为”(空字符串)”,值位 1。
hbase(main):006:0> put 'scores', 'xiapi', 'grad:', '1'
0 row(s) in 0.0220 seconds
hbase(main):007:0>
hbase(main):007:0> put 'scores', 'xiapi', 'grad:', '2' --修改操作
0 row(s) in 0.0270 seconds
hbase(main):008:0>
|
b. 给“xiapi”这一行的数据的列族“course”添加一列。
hbase(main):008:0> put 'scores', 'xiapi', 'course:china', '97'
0 row(s) in 0.0380 seconds
hbase(main):009:0> put 'scores', 'xiapi', 'course:math', '128'
0 row(s) in 0.0090 seconds
hbase(main):010:0> put 'scores', 'xiapi', 'course:english', '85'
0 row(s) in 0.0210 seconds
hbase(main):011:0>
|
5. get 命令(得到一条数据)
a.查看表“scores”中的行“xiapi”的相关数据。
hbase(main):011:0> get 'scores', 'xiapi'
COLUMN CELL
course:china timestamp=1410191209388, value=97
course:english timestamp=1410191240468, value=85
course:math timestamp=1410191232069, value=128
grad: timestamp=1410191119678, value=2
4 row(s) in 0.0710 seconds
hbase(main):012:0>
|
b.查看表“scores”中行“xiapi”列“course :math”的值。
hbase(main):013:0> get 'scores', 'xiapi', 'course:math'
COLUMN CELL
course:math timestamp=1410191232069, value=128
1 row(s) in 0.0160 seconds
hbase(main):014:0>
|
或者
hbase(main):014:0> get 'scores', 'xiapi', {COLUMN=>'course:math'}
COLUMN CELL
course:math timestamp=1410191232069, value=128
1 row(s) in 0.0170 seconds
hbase(main):015:0> get 'scores', 'xiapi', {COLUMNS=>'course:math'}
COLUMN CELL
course:math timestamp=1410191232069, value=128
1 row(s) in 0.0180 seconds
hbase(main):016:0>
|
备注:COLUMN 和 COLUMNS 是不同的,scan 操作中的 COLUMNS 指定的是表的列族, get操作中的 COLUMN 指定的是特定的列,COLUMNS 的值实质上为“列族:列修饰符”。COLUMN 和 COLUMNS 必须为大写。
6. scan 命令(获取数据库表全部数据)
a. 查看表“scores”中的所有数据。
hbase(main):016:0> scan 'scores'
ROW COLUMN+CELL
songhn column=grad:math, timestamp=1410191032626, value=100
xiapi column=course:china, timestamp=1410191209388, value=97
xiapi column=course:english, timestamp=1410191240468, value=85
xiapi column=course:math, timestamp=1410191232069, value=128
xiapi column=grad:, timestamp=1410191119678, value=2
2 row(s) in 0.0650 seconds
hbase(main):017:0>
|
注意:
scan 命令可以指定 startrow,stoprow 来 scan 多个 row。
例如:
scan 'user_test',{COLUMNS =>'info:username',LIMIT =>10, STARTROW => 'test', STOPROW=>'test2'}
b.查看表“scores”中列族“course”的所有数据。
hbase(main):020:0>
scan 'scores', {COLUMN => 'grad'}
ROW COLUMN+CELL
songhn column=grad:math, timestamp=1410191032626, value=100
xiapi column=grad:, timestamp=1410191119678, value=2
2 row(s) in 0.0540 seconds
hbase(main):021:0>
scan 'scores', {COLUMN=>'course:math'}
ROW COLUMN+CELL
xiapi column=course:math, timestamp=1410191232069, value=128
1 row(s) in 0.0320 seconds
hbase(main):022:0>
scan 'scores', {COLUMNS => 'course'}
ROW COLUMN+CELL
xiapi column=course:china, timestamp=1410191209388, value=97
xiapi column=course:english, timestamp=1410191240468, value=85
xiapi column=course:math, timestamp=1410191232069, value=128
1 row(s) in 0.0310 seconds
hbase(main):023:0>
|
7. count 命令(统计数据)
hbase(main):024:0>
count 'scores'
2 row(s) in 0.0270 seconds
hbase(main):025:0>
|
8. exists 命令(判别数据表是否存在)
hbase(main):025:0>
exists 'scores'
Table scores does exist
0 row(s) in 0.0810 seconds
hbase(main):026:0>
|
9. delete 命令(删除表中的某一列)
删除表“scores”中行为“xiaoxue”, 列族“course”中的“math”。
hbase(main):029:0>
delete 'scores', 'xiapi', 'course:math'
0 row(s) in 0.0170 seconds
hbase(main):030:0>
|
10. truncate 命令(截断一张表)
hbase(main):030:0>
truncate 'scores'
Truncating 'scores' table (it may take a while):
- Disabling table...
- Dropping table...
- Creating table...
0 row(s) in 4.4990 seconds
hbase(main):031:0>
|
11. disbale、drop 命令(删除表-先将表不可用,再删除)
通过“disable”和“drop”命令删除“scores”表。
hbase(main):002:0>
disable 'scores'
0 row(s) in 3.3360 seconds
hbase(main):003:0>
drop 'scores'
0 row(s) in 1.1390 seconds
hbase(main):004:0>
exists 'scores'
Table scores does not exist
0 row(s) in 0.0760 seconds
hbase(main):005:0>
|
12. status命令(查看数据库当前运行状态)
ase(main):005:0>
status
2 servers, 0 dead, 2.0000 average load
hbase(main):006:0>
|
13. version命令(查看数据库的版本信息)
hbase(main):006:0>
version
0.94.2, r1395367, Sun Oct 7 19:11:01 UTC 2012
hbase(main):007:0>
|
注意:在 shell 中,常量不需要用引号引起来,但二进制的值需要双引号引起来,而其他值则用单引号引起来。HBase Shell 的常量可以通过在 shell 中输入“Object.constants”。