HBase客户端API - HBase教程
本章介绍用于对HBase表上执行CRUD操作的HBase Java客户端API。 HBase是用Java编写的,并具有Java原生API。因此,它提供了编程访问数据操纵语言(DML)。
HBaseConfiguration类
添加 HBase 的配置到配置文件。这个类属于org.apache.hadoop.hbase包。
方法及说明
S.No. |
方法及说明 |
1 |
static org.apache.hadoop.conf.Configuration create()此方法创建使用HBase的资源配置 |
HTable类
HTable表示HBase表中HBase的内部类。它用于实现单个HBase表进行通信。这个类属于org.apache.hadoop.hbase.client类。
构造函数
S.No. |
构造函数 |
1 |
HTable() |
2 |
HTable(TableName tableName, ClusterConnection connection, ExecutorService pool)使用此构造方法,可以创建一个对象来访问HBase表。 |
方法及说明
S.No. |
构造函数 |
1 |
void close()释放HTable的所有资源 |
2 |
void delete(Delete delete)删除指定的单元格/行 |
3 |
boolean exists(Get get)使用这个方法,可以测试列的存在,在表中,由Get指定获取。 |
4 |
Result get(Get get)检索来自一个给定的行某些单元格。 |
5 |
org.apache.hadoop.conf.Configuration getConfiguration()返回此实例的配置对象。 |
6 |
TableName getName()返回此表的表名称实例。 |
7 |
HTableDescriptor getTableDescriptor()返回此表的表描述符。 |
8 |
byte[] getTableName()返回此表的名称。 |
9 |
void put(Put put)使用此方法,可以将数据插入到表中。 |
Put类
此类用于为单个行执行PUT操作。它属于org.apache.hadoop.hbase.client包。
构造函数
S.No. |
构造函数和描述 |
1 |
Put(byte[] row)使用此构造方法,可以创建一个将操作指定行。 |
2 |
Put(byte[] rowArray, int rowOffset, int rowLength)使用此构造方法,可以使传入的行键的副本,以保持到本地。 |
3 |
Put(byte[] rowArray, int rowOffset, int rowLength, long ts)使用此构造方法,可以使传入的行键的副本,以保持到本地。 |
4 |
Put(byte[] row, long ts)使用此构造方法,我们可以创建一个Put操作指定行,用一个给定的时间戳。 |
方法
S.No. |
方法及描述 |
1 |
Put add(byte[] family, byte[] qualifier, byte[] value)添加指定的列和值到 Put 操作。 |
2 |
Put add(byte[] family, byte[] qualifier, long ts, byte[] value)添加指定的列和值,使用指定的时间戳作为其版本到Put操作。 |
3 |
Put add(byte[] family, ByteBuffer qualifier, long ts, ByteBuffer value)添加指定的列和值,使用指定的时间戳作为其版本到Put操作。 |
4 |
Put add(byte[] family, ByteBuffer qualifier, long ts, ByteBuffer value)添加指定的列和值,使用指定的时间戳作为其版本到Put操作。 |
Get类
此类用于对单行执行get操作。这个类属于org.apache.hadoop.hbase.client包。
构造函数
S.No. |
构造函数和描述 |
1 |
Get(byte[] row)使用此构造方法,可以为指定行创建一个Get操作。 |
2 |
Get(Get get) |
方法
S.No. |
构造函数和描述 |
1 |
Get addColumn(byte[] family, byte[] qualifier)检索来自特定列家族使用指定限定符 |
2 |
Get addFamily(byte[] family)检索从指定系列中的所有列。 |
Delete类
这个类用于对单行执行删除操作。要删除整行,实例化一个Delete对象用于删除行。这个类属于org.apache.hadoop.hbase.client包。
构造函数
S.No. |
构造方法和描述 |
1 |
Delete(byte[] row)创建一个指定行的Delete操作。 |
2 |
Delete(byte[] rowArray, int rowOffset, int rowLength)创建一个指定行和时间戳的Delete操作。 |
3 |
Delete(byte[] rowArray, int rowOffset, int rowLength, long ts)创建一个指定行和时间戳的Delete操作。 |
4 |
Delete(byte[] row, long timestamp)创建一个指定行和时间戳的Delete操作。 |
方法
S.No. |
构造方法和描述 |
1 |
Delete addColumn(byte[] family, byte[] qualifier)删除指定列的最新版本。 |
2 |
Delete addColumns(byte[] family, byte[] qualifier, long timestamp)删除所有版本具有时间戳小于或等于指定的时间戳的指定列。 |
3 |
Delete addFamily(byte[] family)删除指定的所有列族的所有版本。 |
4 |
Delete addFamily(byte[] family, long timestamp)删除指定列具有时间戳小于或等于指定的时间戳的列族。 |
Result类
这个类是用来获取Get或扫描查询的单行结果。
构造函数
S.No. |
构造函数 |
1 |
Result()使用此构造方法,可以创建无Key Value的有效负载空的结果;如果调用Cells()返回null。 |
方法
S.No. |
方法及描述 |
1 |
byte[] getValue(byte[] family, byte[] qualifier)此方法用于获取指定列的最新版本 |
2 |
byte[] getRow()此方法用于检索对应于从结果中创建行的行键。 |