Jave Hbase API

Hbase API 类和数据模型的对应关系

 

 

 

HBaseAdmin

 

类:org.apache.hadoop.hbase.client.HBaseAdmin

作用：提供了一个接口来管理 HBase 数据库的表信息。它提供的方法包括：创建表，删 除表，列出表项，使表有效或无效，以及添加或删除表列族成员等。

 

 

 

 

HBaseConfiguration

 

类：org.apache.hadoop.hbase.HBaseConfiguration

作用：对 HBase 进行配置

 

 

 

HTableDescriptor

 

类： org.apache.hadoop.hbase.HTableDescriptor

作用：包含了表的名字极其对应表的列族

 

 

 

 

 

HColumnDescriptor

 

 

类： org.apache.hadoop.hbase.HColumnDescriptor

作用：维护着关于列族的信息，例如版本号，压缩设置等。它通常在创建表或者为表添 加列族的时候使用。列族被创建后不能直接修改，只能通过删除然后重新创建的方式。列族被删除的时候，列族里面的数据也会同时被删除。

 

 

 

 

 

 

HTable

 

 

 

 

 

 

 

 

Put

 

类： org.apache.hadoop.hbase.client.Put

作用：用来对单个行执行添加操作

 

 

 

 

 

 

Get

 

 

类： org.apache.hadoop.hbase.client.Get

作用：用来获取单个行的相关信息

 

 

 

 

Result

类： org.apache.hadoop.hbase.client.Result

作用：存储 Get 或者 Scan 操作后获取表的单行值。使用此类提供的方法可以直接获取值 或者各种 Map 结构（ key-value 对）

 

 

创建表

 

package com.shujia;

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.TableName;
import org.apache.hadoop.hbase.client.Admin;
import org.apache.hadoop.hbase.client.Connection;
import org.apache.hadoop.hbase.client.ConnectionFactory;

import java.io.IOException;

public class Demo01 {
    public static void main(String[] args) throws IOException {

        //创建配置，指定zk集群
        Configuration conf = HBaseConfiguration.create();
        conf.set("hbase.zookeeper.quorum","master,node1,node2");

        //创建连接
        Connection coon = ConnectionFactory.createConnection(conf);

        //创建admin对象
        Admin admin = coon.getAdmin();

        //创建表
        HTableDescriptor test_api = new HTableDescriptor(TableName.valueOf("test_api"));

        //创建列簇
        HColumnDescriptor cf1 = new HColumnDescriptor("cf1");

        //配置列簇
        cf1.setTimeToLive(20); //设置死亡时间20s
        cf1.setMaxVersions(3); //设置版本

        //增加列簇
        test_api.addFamily(cf1);

        //创建表
        admin.createTable(test_api);

        //关闭连接
        coon.close();
    }
}

 

 

package com.shujia;

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.TableName;
import org.apache.hadoop.hbase.client.*;
import org.apache.hadoop.hbase.util.Addressing;
import org.apache.hadoop.hbase.util.Bytes;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

import javax.swing.tree.VariableHeightLayoutCache;
import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.util.ArrayList;

public class Demo03API {
    Connection conn;
    TableName table=TableName.valueOf("test_api");

    @Before
    public void init() throws IOException {
        Configuration conf = HBaseConfiguration.create();
        conf.set("hbase.zookeeper.quorum","master,node1,node2");

        conn = ConnectionFactory.createConnection(conf);
    }
    //put
    @Test
    public void Put() throws IOException {
        Table test_api = conn.getTable(TableName.valueOf("test_api"));
        Put put = new Put("001".getBytes());
        put.addColumn("cf1".getBytes(),"name".getBytes(),"张三".getBytes());
        test_api.put(put);
    }

    // putAll 读取students.txt 并将数据写入HBase
    @Test
    public void PutAll() throws IOException {
        // 创建students表 info
        Admin admin = conn.getAdmin();
        TableName studentsT = TableName.valueOf("students");
        // 判断表是否存在
        if (!admin.tableExists(studentsT)) {
            HTableDescriptor students = new HTableDescriptor(studentsT);
            HColumnDescriptor info = new HColumnDescriptor("info");
            students.addFamily(info);
            admin.createTable(students);
        }

        Table stu = conn.getTable(studentsT);


        BufferedReader br = new BufferedReader(new FileReader("data/students.txt"));
        String line = null;
        ArrayList<Put> puts = new ArrayList<Put>();
        int batchSize = 11;
        while ((line = br.readLine()) != null) {

            // 读取每一行数据
            String[] split = line.split(",");
            String id = split[0];
            String name = split[1];
            String age = split[2];
            String gender = split[3];
            String clazz = split[4];
            Put put = new Put(id.getBytes());
            put.addColumn("info".getBytes(), "name".getBytes(), name.getBytes());
            put.addColumn("info".getBytes(), "age".getBytes(), age.getBytes());
            put.addColumn("info".getBytes(), "gender".getBytes(), gender.getBytes());
            put.addColumn("info".getBytes(), "clazz".getBytes(), clazz.getBytes());
            puts.add(put); // 将每条数据构建好的put对象加入puts列表
            if (puts.size() == batchSize) {
                stu.put(puts); // 批量写入
                puts = new ArrayList<Put>();
            }
        }
        if (puts.size() != 0) {
            stu.put(puts); // 批量写入
        }

    }
    //get
    @Test
    public void Get() throws IOException {
        Table test_api = conn.getTable(table);
        Get get = new Get("001".getBytes());
        Result rs = test_api.get(get);
        byte[] value = rs.getValue("cf1".getBytes(), "name".getBytes());
        System.out.println( Bytes.toString(value));
    }


    @Test//alter table 修改表
    public void alterTable() throws IOException {
        Admin admin = conn.getAdmin();
        //获取表原有的结果
        HTableDescriptor tableDescriptor = admin.getTableDescriptor(table);
        //获取所有列簇构成的数组
        HColumnDescriptor[] columnFamilies = tableDescriptor.getColumnFamilies();
        //遍历列簇
        for (HColumnDescriptor columnFamily : columnFamilies) {
            //获取列簇名称
            String cfName = columnFamily.getNameAsString();
            //对列簇名为cf1的进行修改
            if("cf1".equals(cfName)){
                //修改TTL
                columnFamily.setTimeToLive(100000);
            }
        }
        //修改表结构
        admin.modifyTable(table,tableDescriptor);


    }

    @After
    public void closed() throws IOException {
        conn.close();
    }
}