流式大数据计算实践（5）----HBase使用&SpringBoot集成

一、前言

1、上文中我们搭建好了一套HBase集群环境，这一文我们学习一下HBase的基本操作和客户端API的使用

二、shell操作

先通过命令进入HBase的命令行操作

/work/soft/hbase-1.2.2/bin/hbase shell

1、建表

create 'test', 'cf'

（1）以上命令是建立一个test表，里面有一个列族cf

（2）与RDS不同，HBase的列不是必须的，当向列族中插入一个单元格数据时，才有了列

2、查看所有表

list

3、查看表属性

describe 'test'

4、增加列族

alter 'test', 'cf2'

5、插入数据

put 'test', 'row1', 'cf:name', 'jack'

（1）命令解释：向test表中的row1行插入列族cf，列名name的数据jack

6、查询行数据

scan 'test', {STARTROW => 'row3'}
scan 'test', {ENDROW => 'row4'}

（1）命令解释：查找test表中rowkey大于等于row3的数据

（2）命令解释：查找test表中rowkey小于row4的数据（不包括row4）

7、查询单元格数据

get 'test', 'row7', 'cf:name'

8、删除数据

delete 'test', 'row4', 'cf:name'

（1）命令解释：删除test表中row4行的cf:name列的单元格数据

三、客户端API

正常开发中操作HBase多数情况下通过客户端API操作，我们这里使用Java来操作，jdk要求至少1.7以上，编译器我这里用的是IntelliJ IDEA

（1）新建一个maven工程

（2）打开pom文件，引入HBase的依赖

<dependency>
    <groupId>org.apache.hbase</groupId>
    <artifactId>hbase-client</artifactId>
    <version>2.1.1</version>
</dependency>

（3）将HBase的相关配置文件引入到我们的maven项目中，拷贝HBase目录下的hbase-site.xml和Hadoop目录下的core-site.xml，将两个文件复制到src/main/resources目录下

（4）记得将前文中虚拟机的IP和hostname映射配置到写代码这台机器的hosts文件中（比如win7的hosts目录为C:WindowsSystem32driversetc）

（5）新建一个类，编写CRUD的示例代码，下面代码用了jdk1.7的一个语法糖：try-with-resources，在try()里面声明的对象，会自动帮你调用对象的close方法来关闭对象，不用手动调用close()，非常方便

import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.fs.Path;
import org.apache.hadoop.hbase.*;
import org.apache.hadoop.hbase.client.*;
import org.apache.hadoop.hbase.io.compress.Compression;
import org.apache.hadoop.hbase.util.Bytes;

import java.io.IOException;
import java.net.URISyntaxException;

public class HelloHBase
{
    public static void main(String[] args) throws URISyntaxException
    {
        // 加载HBase的配置
        Configuration configuration = HBaseConfiguration.create();

        // 读取配置文件
        configuration.addResource(new Path(ClassLoader.getSystemResource("hbase-site.xml").toURI()));
        configuration.addResource(new Path(ClassLoader.getSystemResource("core-site.xml").toURI()));

        try (// 创建一个HBase连接
             Connection connection = ConnectionFactory.createConnection(configuration);
             // 获得执行操作的管理接口
             Admin admin = connection.getAdmin();)
        {
            // 新建一个表名为mytable的表
            TableName tableName = TableName.valueOf("mytable");
            HTableDescriptor tableDescriptor = new HTableDescriptor(tableName);

            // 新建一个列族名为mycf的列族
            HColumnDescriptor mycf = new HColumnDescriptor("mycf");
            // 将列族添加到表中
            tableDescriptor.addFamily(mycf);
            // 执行建表操作
            createOrOverwrite(admin, tableDescriptor);

            // 设置列族的压缩方式为GZ
            mycf.setCompactionCompressionType(Compression.Algorithm.GZ);
            // 设置最大版本数量（ALL_VERSIONS实际上就是Integer.MAX_VALUE）
            mycf.setMaxVersions(HConstants.ALL_VERSIONS);
            // 列族更新到表中
            tableDescriptor.modifyFamily(mycf);
            // 执行更新操作
            admin.modifyTable(tableName, tableDescriptor);

            // 新增一个列族
            HColumnDescriptor hColumnDescriptor = new HColumnDescriptor("newcf");
            hColumnDescriptor.setCompactionCompressionType(Compression.Algorithm.GZ);
            hColumnDescriptor.setMaxVersions(HConstants.ALL_VERSIONS);
            // 执行新增操作
            admin.addColumnFamily(tableName, hColumnDescriptor);

            // 获取表对象
            Table table = connection.getTable(tableName);

            // 创建一个put请求，用于添加数据或者更新数据
            Put put = new Put(Bytes.toBytes("row1"));
            put.addColumn(Bytes.toBytes("mycf"), Bytes.toBytes("name"), Bytes.toBytes("jack"));
            table.put(put);

            // 创建一个append请求，用于在数据后面添加内容
            Append append = new Append(Bytes.toBytes("row1"));
            append.add(Bytes.toBytes("mycf"), Bytes.toBytes("name"), Bytes.toBytes("son"));
            table.append(append);

            // 创建一个long类型的列
            Put put1 = new Put(Bytes.toBytes("row2"));
            put1.addColumn(Bytes.toBytes("mycf"), Bytes.toBytes("age"), Bytes.toBytes(6L));
            // 创建一个增值请求，将值增加10L
            Increment increment = new Increment(Bytes.toBytes("row2"));
            increment.addColumn(Bytes.toBytes("mycf"), Bytes.toBytes("age"), 10L);
            table.increment(increment);

            // 创建一个查询请求，查询一行数据
            Get get = new Get(Bytes.toBytes("row1"));
            // 由于HBase的一行可能非常大，所以限定要取出的列族
            get.addFamily(Bytes.toBytes("mycf"));
            // 创建一个结果请求
            Result result = table.get(get);
            // 从查询结果中取出name列，然后打印（这里默认取最新版本的值，如果要取其他版本要使用Cell对象）
            byte[] name = result.getValue(Bytes.toBytes("mycf"), Bytes.toBytes("name"));
            System.out.println(Bytes.toString(name));

            // 创建一个扫描请求，查询多行数据
            Scan scan = new Scan(Bytes.toBytes("row1"));
            // 设置扫描器的缓存数量，遍历数据时不用发多次请求，默认100，适当的缓存可以提高性能
            scan.setCaching(150);
            // 创建扫描结果，这个时候不会真正从HBase查询数据，下面的遍历才是去查询
            ResultScanner resultScanner = table.getScanner(scan);
            for (Result r : resultScanner)
            {
                String data = Bytes.toString(r.getValue(Bytes.toBytes("mycf"), Bytes.toBytes("name")));
                System.out.println(data);
            }
            // 使用完毕关闭
            resultScanner.close();

            // 创建一个删除请求
            Delete delete = new Delete(Bytes.toBytes("row2"));
            // 可以自定义一些筛选条件
            delete.addFamily(Bytes.toBytes("age"));
            table.delete(delete);

            // 停用表
            admin.disableTable(tableName);
            // 删除列族
            admin.deleteColumnFamily(tableName, "mycf".getBytes());
            // 删除表
            admin.deleteTable(tableName);
        }
        catch (Exception e)
        {
            e.printStackTrace();
        }
        System.out.println("ok");
    }

    public static void createOrOverwrite(Admin admin, HTableDescriptor table) throws IOException
    {
        // 获取table名
        TableName tableName = table.getTableName();
        // 判断table是否存在，如果存在则先停用并删除
        if (admin.tableExists(tableName))
        {
            // 停用表
            admin.disableTable(tableName);
            // 删除表
            admin.deleteTable(tableName);
        }
        // 创建表
        admin.createTable(table);
    }
}

 四、API的高级用法

上一章介绍了API的基本使用方法，这一章总结一些高级用法

1、过滤器：通过get或者scan查找数据时，经常需要加入一些条件来查找

（1）值过滤器：相当于传统sql的where column like '%jack%'，但是会对所有的列都做过滤，如果需要对单个列过滤，可以使用SingleColumnValueFilter，如果需要查询值相等的过滤器，可以使用BinaryComparator

CompareFilter filter = new ValueFilter(CompareFilter.CompareOp.EQUAL, new SubstringComparator("jack"));
scan.setFilter(filter);

（2）分页过滤器：相当于传统sql的limit，但是不能指定起始页码，所以需要自己记录最后一个row key，并通过scan.setStartRow()设置，在做分页时有个小技巧，如果你通过scan.setStartRow()设置最后一个row key时，下一页的数据依然会包含上一页的最后一个数据，所以你可以将最后一个row key的末尾加一个0，就可以不包含最后一个数据了，因为row key是按照字典顺序排序的

Filter filter1 = new PageFilter(10L);
scan.setFilter(filter1);

（3）过滤器列表：用于组合多个过滤器，实现复杂一些的查询场景，注意这个过滤器列表是有顺序的，FilterList的第一个参数用来指定多个条件的连接方式（and、or），MUST_PASS_ALL相当于and连接，MUST_PASS_ONE相当于or连接

FilterList filterList = new FilterList(FilterList.Operator.MUST_PASS_ALL);
filterList.addFilter(filter);
filterList.addFilter(filter1);
scan.setFilter(filterList);

（4）还有一些其他的过滤器，使用方法大同小异，比如行键过滤器、列过滤器、单元格过滤器，甚至可以自定义过滤器，其他高级用法可以等用到再看

五、SpringBoot集成

1、后台我们用SpringCloud的微服务搭建，本章是用SpringBoot集成HBase环境，SpringBoot项目的搭建非常简单

2、首先将HBase的相关配置文件引入到我们已经搭建好的的SpringBoot项目中，拷贝HBase目录下的hbase-site.xml和Hadoop目录下的core-site.xml、hdfs-site.xml，将三个文件复制到src/main/resources目录下

3、编写一个Java配置文件来集成HBase环境

import org.apache.hadoop.fs.Path;
import org.apache.hadoop.hbase.HBaseConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.hadoop.hbase.HbaseTemplate;

import java.net.URISyntaxException;

@Configuration
public class HBaseConfig
{
    @Bean
    public HbaseTemplate hbaseTemplate()
    {
        HbaseTemplate hbaseTemplate = new HbaseTemplate();
        hbaseTemplate.setConfiguration(getConfiguration());
        hbaseTemplate.setAutoFlush(true);
        return hbaseTemplate;
    }

    private org.apache.hadoop.conf.Configuration getConfiguration()
    {
        try
        {
            org.apache.hadoop.conf.Configuration configuration = HBaseConfiguration.create();
            configuration.addResource(new Path(ClassLoader.getSystemResource("hdfs-site.xml").toURI()));
            configuration.addResource(new Path(ClassLoader.getSystemResource("core-site.xml").toURI()));
            configuration.addResource(new Path(ClassLoader.getSystemResource("hbase-site.xml").toURI()));
            return configuration;
        }
        catch (URISyntaxException e)
        {
            e.printStackTrace();
        }
        return null;
    }
}

4、上面的配置中将HBase操作的对象注入到Spring中，所以当我们需要操作HBase时，直接使用HbaseTemplate即可，下例中是将一条数据插入到HBase中，可以看出HbaseTemplate高度封装了CRUD，使用起来更加简单方便

@Service
public class HBaseService implements IHBaseService
{
    @Autowired
    private HbaseTemplate hbaseTemplate;

    @Override
    public void saveDeviceHeartbeat(String uuid, JSONObject heartObject)
    {
        hbaseTemplate.put("mytable", "row1", "mycf", "uuid", Bytes.toBytes(uuid));
    }
}