Hbase的客户端有原生java客户端,Hbase Shell,Thrift,Rest,Mapreduce,WebUI等等。
下面是这几种客户端的常见用法。
一、原生Java客户端
原生java客户端是hbase最主要,最高效的客户端。
涵盖了增删改查等API,还实现了创建,删除,修改表等DDL操作。
配置java连接hbase
Java连接HBase需要两个类:
- HBaseConfiguration
- ConnectionFactory
首先,配置一个hbase连接:
比如zookeeper的地址端口hbase.zookeeper.quorumhbase.zookeeper.property.clientPort
更通用的做法是编写hbase-site.xml文件,实现配置文件的加载:
hbase-site.xml示例:
<configuration><property><name>hbase.master</name><value>hdfs://host1:60000</value></property><property><name>hbase.zookeeper.quorum</name><value>host1,host2,host3</value></property><property><name>hbase.zookeeper.property.clientPort</name><value>2181</value></property></configuration>
随后我们加载配置文件,创建连接:
config.addResource(new Path(System.getenv("HBASE_CONF_DIR"), "hbase-site.xml")); Connection connection = ConnectionFactory.createConnection(config);创建表
要创建表我们需要首先创建一个Admin对象
Admin admin = connection.getAdmin(); //使用连接对象获取Admin对象TableName tableName = TableName.valueOf("test");//定义表名HTableDescriptor htd = new HTableDescriptor(tableName);//定义表对象HColumnDescriptor hcd = new HColumnDescriptor("data");//定义列族对象htd.addFamily(hcd); //添加admin.createTable(htd);//创建表HBase2.X创建表
HBase2.X 的版本中创建表使用了新的 API
TableName tableName = TableName.valueOf("test");//定义表名//TableDescriptor对象通过TableDescriptorBuilder构建;TableDescriptorBuilder tableDescriptor = TableDescriptorBuilder.newBuilder(tableName);ColumnFamilyDescriptor family = ColumnFamilyDescriptorBuilder.newBuilder(Bytes.toBytes("data")).build();//构建列族对象tableDescriptor.setColumnFamily(family);//设置列族admin.createTable(tableDescriptor.build());//创建表添加数据Table table = connection.getTable(tableName);//获取Table对象try { byte[] row = Bytes.toBytes("row1"); //定义行 Put put = new Put(row); //创建Put对象 byte[] columnFamily = Bytes.toBytes("data"); //列 byte[] qualifier = Bytes.toBytes(String.valueOf(1)); //列族修饰词 byte[] value= Bytes.toBytes("张三丰"); //值 put.addColumn(columnFamily, qualifier, value); table.put(put); //向表中添加数据} finally { //使用完了要释放资源 table.close();}获取指定行数据//获取数据Get get = newGet(Bytes.toBytes("row1")); //定义get对象Result result = table.get(get); //通过table对象获取数据System.out.println("Result: " + result);//很多时候我们只需要获取“值” 这里表示获取 data:1 列族的值byte[] valueBytes = result.getValue(Bytes.toBytes("data"), Bytes.toBytes("1")); //获取到的是字节数组//将字节转成字符串String valueStr = new String(valueBytes,"utf-8");System.out.println("value:" + valueStr);扫描表中的数据Scan scan = new Scan();ResultScanner scanner = table.getScanner(scan);try { for (Result scannerResult: scanner) { System.out.println("Scan: " + scannerResult); byte[] row = scannerResult.getRow(); System.out.println("rowName:" + new String(row,"utf-8")); }} finally { scanner.close();}删除表TableName tableName = TableName.valueOf("test");admin.disableTable(tableName); //禁用表admin.deleteTable(tableName); //删除表
Hbase Java API表DDL完整示例:
packa