HBase提供了java api来对HBase进行一系列的管理涉及到对表的管理、数据的操作等。常用的API操作有:
1、 对表的创建、删除、显示以及修改等,可以用HBaseAdmin,一旦创建了表,那么可以通过HTable的实例来访问表,每次可以往表里增加数据。
2、 插入数据
创建一个Put对象,在这个Put对象里可以指定要给哪个列增加数据,以及当前的时间戳等值,然后通过调用HTable.put(Put)来提交操作,在这里提请注意的是:在创建Put对象的时候,你必须指定一个行(Row)值,在构造Put对象的时候作为参数传入。
3、 获取数据
要获取数据,使用Get对象,Get对象同Put对象一样有好几个构造函数,通常在构造的时候传入行值,表示取第几行的数据,通过HTable.get(Get)来调用。
4、 浏览每一行
通过Scan可以对表中的行进行浏览,得到每一行的信息,比如列名,时间戳等,Scan相当于一个游标,通过next()来浏览下一个,通过调用HTable.getScanner(Scan)来返回一个ResultScanner对象。HTable.get(Get)和HTable.getScanner(Scan)都是返回一个Result。Result是一个Key/Value的链表。
5、 删除
使用Delete来删除记录,通过调用HTable.delete(Delete)来执行删除操作。(注:删除这里有些特别,也就是删除并不是马上将数据从表中删除。)
6、 锁
新增、获取、删除在操作过程中会对所操作的行加一个锁,而浏览却不会。
7、 簇的访问
客户端代码通过ZooKeeper来访问找到簇,也就是说ZooKeeper quorum将被使用,那么相关的类(包)应该在客户端的类(classes)目录下,即客户端一定要找到文件hbase-site.xml。
新建一个类:
package com.jhl.hbase;
import java.util.ArrayList;
import java.util.List;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.hbase.HBaseConfiguration;
import org.apache.hadoop.hbase.HColumnDescriptor;
import org.apache.hadoop.hbase.HTableDescriptor;
import org.apache.hadoop.hbase.KeyValue;
import org.apache.hadoop.hbase.client.Delete;
import org.apache.hadoop.hbase.client.Get;
import org.apache.hadoop.hbase.client.HBaseAdmin;
import org.apache.hadoop.hbase.client.HTable;
import org.apache.hadoop.hbase.client.Put;
import org.apache.hadoop.hbase.client.Result;
import org.apache.hadoop.hbase.client.ResultScanner;
import org.apache.hadoop.hbase.client.Scan;
import org.apache.hadoop.hbase.util.Bytes;
public class OperateTable {
private static Configuration conf = null;
static {
conf = HBaseConfiguration.create();
conf.set("hbase.zookeeper.quorum", "master");// 使用eclipse时必须添加这个,否则无法定位
conf.set("hbase.zookeeper.property.clientPort", "2181");
}
// 创建数据库表
@SuppressWarnings("deprecation")
public static void createTable(String tableName, String[] columnFamilys)
throws Exception {
HBaseAdmin hadmin = new HBaseAdmin(conf);
if (hadmin.tableExists(tableName)) {
System.out.println("表已存在");
System.exit(0);
} else {
// 新建一个 表的描述
HTableDescriptor tableDesc = new HTableDescriptor(tableName);
// 在描述里添加列族
for (String columnFamily : columnFamilys) {
tableDesc.addFamily(new HColumnDescriptor(columnFamily));
}
// 根据配置好的描述建表
hadmin.createTable(tableDesc);
System.out.println("创建表成功!");
}
}
// 删除数据库表
public static void deleteTable(String tableName) throws Exception {
HBaseAdmin hadmin = new HBaseAdmin(conf);
if (hadmin.tableExists(tableName)) {
// 关闭表
hadmin.disableTable(tableName);
hadmin.deleteTable(tableName);
System.out.println("删除表成功!");
} else {
System.out.println("删除的表不存在");
System.exit(0);
}
}
// 添加一条数据
public static void addRow(String tableName, String row,
String columnFamily, String column, String value) throws Exception {
HTable hTable = new HTable(conf, tableName);
Put put = new Put(Bytes.toBytes(row));
// 参数出分别:列族、列、值
put.add(Bytes.toBytes(columnFamily), Bytes.toBytes(column),
Bytes.toBytes(value));
hTable.put(put);
}
// 删除一条数据
public static void delRow(String tableName, String row) throws Exception {
HTable hTable = new HTable(conf, tableName);
Delete delete = new Delete(Bytes.toBytes(row));
hTable.delete(delete);
}
// 删除多条数据
public static void delMultiRows(String tableName, String[] rows)
throws Exception {
HTable hTable = new HTable(conf, tableName);
List<Delete> list = new ArrayList<Delete>();
for (String row : rows) {
Delete delete = new Delete(Bytes.toBytes(row));
list.add(delete);
}
hTable.delete(list);
}
// get row
public static void getRow(String tableName, String row) throws Exception {
HTable hTable = new HTable(conf, tableName);
Get get = new Get(Bytes.toBytes(row));
Result result = hTable.get(get);
for (KeyValue rowkv : result.raw()) {
System.out.print("Row Name: " + new String(rowkv.getRow()) + " ");
System.out.print("Timestamp: " + rowkv.getTimestamp() + " ");
System.out.print("column Family: " + new String(rowkv.getFamily())
+ " ");
System.out.print("Row Name: " + new String(rowkv.getQualifier())
+ " ");
System.out.println("Value: " + new String(rowkv.getValue()) + " ");
}
}
// get filter row
public static void getFilterRow(String tableName, String row) throws Exception {
HTable hTable = new HTable(conf, tableName);
Get get = new Get(Bytes.toBytes(row));
ByteArrayComparable qualifierComparator = new SubstringComparator("course");
Filter filter = new QualifierFilter(CompareOp.LESS_OR_EQUAL, qualifierComparator);
get.setFilter(filter);
Result result = hTable.get(get);
System.out.println("result= " + result);
for (KeyValue rowkv : result.raw()) {
System.out.print("Row Name: " + new String(rowkv.getRow()) + " ");
System.out.print("Timestamp: " + rowkv.getTimestamp() + " ");
System.out.print("column Family: " + new String(rowkv.getFamily())
+ " ");
System.out.print("Row Name: " + new String(rowkv.getQualifier())
+ " ");
System.out.println("Value: " + new String(rowkv.getValue()) + " ");
}
}
// get all records
public static void getAllRows(String tableName) throws Exception {
HTable hTable = new HTable(conf, tableName);
Scan scan = new Scan();
ResultScanner results = hTable.getScanner(scan);
for (Result result : results) {
for (KeyValue rowKV : result.raw()) {
System.out.print("Row Name: " + new String(rowKV.getRow())
+ " ");
System.out.print("Timestamp: " + rowKV.getTimestamp() + " ");
System.out.print("column Family: "
+ new String(rowKV.getFamily()) + " ");
System.out.print("Row Name: "
+ new String(rowKV.getQualifier()) + " ");
System.out.println("Value: " + new String(rowKV.getValue())
+ " ");
}
}
}
public static void main(String[] args) {
String tableName = "score";
String[] columnFamilys = { "info", "course" };
try {
// OperateTable.createTable(tableName, columnFamilys);
// OperateTable.deleteTable(tableName);
// 添加第一行数据
// OperateTable.addRow(tableName, "tht", "info", "age", "20");
// OperateTable.addRow(tableName, "tht", "info", "sex", "boy");
// OperateTable.addRow(tableName, "tht", "course", "china", "97");
// OperateTable.addRow(tableName, "tht", "course", "math", "128");
// OperateTable.addRow(tableName, "tht", "course", "english", "85");
// 添加第二行数据
// OperateTable.addRow(tableName, "xiaoxue", "info", "age", "19");
// OperateTable.addRow(tableName, "xiaoxue", "info", "sex", "boy");
// OperateTable.addRow(tableName, "xiaoxue", "course", "china", "90");
// OperateTable.addRow(tableName, "xiaoxue", "course", "math", "120");
// OperateTable.addRow(tableName, "xiaoxue", "course", "english", "90");
// 添加第三行数据
// OperateTable.addRow(tableName, "qingqing", "info", "age", "18");
// OperateTable.addRow(tableName, "qingqing", "info", "sex", "girl");
// OperateTable.addRow(tableName, "qingqing", "course", "china", "100");
// OperateTable.addRow(tableName, "qingqing", "course", "math","100");
// OperateTable.addRow(tableName, "qingqing", "course", "english","99");
// OperateTable.getRow(tableName, "xiaoxue");
// OperateTable.getAllRows(tableName);
// OperateTable.delRow(tableName, "tht");
String[] rows = { "xiaoxue", "qingqing" };
OperateTable.delMultiRows(tableName, rows);
OperateTable.getFilterRow(tableName, "tht");
} catch (Exception e) {
e.printStackTrace();
}
}
}