Hbase 整合 Hadoop 的数据迁移
上篇文章说了 Hbase 的基础架构,都是比较理论的知识,最近我也一直在搞 Hbase 的数据迁移, 今天就来一篇实战型的,把最近一段时间的 Hbase 整合 Hadoop 的基础知识在梳理一遍,毕竟当初搞得时候还是有点摸不着方向,写下来也方便以后查阅。
之前使用 Hbase 大多是把它当做实时数据库来做查询使用的,大部分使用的都是 Hbase 的基础 Api, Hbase 与 Hadoop Hive 框架的整合还真是没系统的搞过,话不多说,先看看本文的架构图:
PS:文中提到的代码见最后 参考资料
着重点在前两部分,后面的都是大家比较熟悉的部分了。
1 Hbase 与 Hadoop 集成
Hbase 与 Hadoop 相关操作主要可以分为如下三种情况:
-
一张 hbase 表数据导入另一张 hbase 表
-
HDFS 数据导入 Hbase 表
-
HDFS 数据(超大数据)导入 Hbase 表
以上三种情况的数据迁移基本都是依靠 MR 程序来完成的,所以重点又回到了 MR 编程。
01 hbase表数据导入
思路:准备 MR 程序将一张 Hbase 表写入到另一张 Hbase 表即可。
注意:两张 Hbase 表导入数据的列族信息要一致;有数据的 Hbase 在读入数据时要注意非空判断。
准备工作:
准备 user1 表 列族 为 f1,f1 中有 age ,name属性 ,作为输入表;
准备 user2 表,创建列族 f1,作为输出表。
主要代码:
Mapper 端:这里注意继承的 是 TableMapper
1 public class HBaseReadMapper extends TableMapper<Text,Put> { 2 /** 3 * 4 * @param key rowkey 5 * @param value rowkey 此行的数据 Result 类型 6 * @param context 7 * @throws IOException 8 * @throws InterruptedException 9 */ 10 @Override 11 protected void map(ImmutableBytesWritable key, Result value, Context context) throws IOException, InterruptedException { 12 //获得rowkey 的字节数组 13 byte[] rowkey_bytes = key.get(); 14 String rowKeyStr = Bytes.toString(rowkey_bytes); 15 //准备好 put 对象 用于输出下游 16 Put put = new Put(rowkey_bytes); 17 //text 作为输出的 key 18 Text text = new Text(rowKeyStr); 19 //输出数据 - 写数据 - 普通 构建put 对象 20 Cell[] cells = value.rawCells(); 21 //将 f1 : name & age 输出 22 for (Cell cell : cells) { 23 //当前 cell是否是 f1 24 //获取列族 25 byte[] family = CellUtil.cloneFamily(cell); 26 String familyStr = Bytes.toString(family); 27 28 if("f1".equals(familyStr)){ 29 //在判断是否是 name | age 30 put.add(cell); 31 } 32 33 if("f2".equals(familyStr)){ 34 put.add(cell); 35 } 36 } 37 //注意非空判断 不然会报错 38 if(!put.isEmpty()){ 39 context.write(text,put); 40 } 41 42 } 43 }
Reduce 端 ,使用 TableReducer:
1 public class HbaseWriteReducer extends TableReducer<Text,Put,ImmutableBytesWritable> { 2 3 /** 4 * 将 map 传过来的数据写出去 5 * @param key 6 * @param values 7 * @param context 8 * @throws IOException 9 * @throws InterruptedException 10 */ 11 @Override 12 protected void reduce(Text key, Iterable<Put> values, Context context) throws IOException, InterruptedException { 13 //设置rowkey 14 ImmutableBytesWritable immutableBytesWritable = new ImmutableBytesWritable(); 15 //设置rowkey 16 immutableBytesWritable.set(key.toString().getBytes()); 17 for (Put value : values) { 18 context.write(immutableBytesWritable,value); 19 } 20 } 21 }
启动类,将 user1 中 f1 列族下 age,name数值写入到 user2 中:
1 public class Hbase2HbaseMR extends Configured implements Tool { 2 3 public static void main(String[] args) throws Exception { 4 Configuration configuration = HBaseConfiguration.create(); 5 //设置 hbase 的zk地址 6 configuration.set("hbase.zookeeper.quorum","hadoop102:2181,hadoop103:2181,hadoop104:2181"); 7 int run = ToolRunner.run(configuration, new Hbase2HbaseMR(), args); 8 System.exit(run); 9 } 10 @Override 11 public int run(String[] strings) throws Exception { 12 Job job = Job.getInstance(super.getConf()); 13 job.setJarByClass(Hbase2HbaseMR.class); 14 //mapper 15 TableMapReduceUtil.initTableMapperJob(TableName.valueOf("user"),new Scan(), HBaseReadMapper.class,Text.class,Put.class,job); 16 //reducer 17 TableMapReduceUtil.initTableReducerJob("user2",HbaseWriteReducer.class,job); 18 boolean b = job.waitForCompletion(true); 19 20 return b?0:1; 21 } 22 }
02 HDFS 导入到Hbase
思路:准备 MR 程序将 HDFS 数据写入到另一张 Hbase 表即可。
注意:
读入的是 Mapper 是 HDFS 操作,写出的 Reduce 是 Hbase 操作;
HDFS 数据格式要与 Hbase 表对应
准备工作:
准备 HDFS 上数据 ;
准备 user2 表,创建列族 f1,作为输出表。
主要代码:
Mapper 端,使用常规 Mapper
1 public class HdfsMapper extends Mapper<LongWritable,Text,Text,NullWritable>{ 2 3 /** 4 * HDFS -- Hbase 5 * 6 * @param key 7 * @param value 8 * @param context 9 * @throws IOException 10 * @throws InterruptedException 11 */ 12 @Override 13 protected void map(LongWritable key, Text value, Context context) throws IOException, InterruptedException { 14 //数据原样输出 15 context.write(value,NullWritable.get()); 16 } 17 }
Reduce 端,使用 TableReducer :
1 public static class HBASEReducer extends TableReducer<Text,NullWritable,ImmutableBytesWritable>{ 2 @Override 3 protected void reduce(Text key, Iterable<NullWritable> values, Context context) throws IOException, InterruptedException { 4 /** 5 * key --> 一行数据 6 * 样例数据: 7 * 07 zhangsan 18 8 * 08 lisi 25 9 * 09 wangwu 20 10 * 11 */ 12 //按格式拆分 13 String[] split = key.toString().split("\t"); 14 //构建 put 对象 15 Put put = new Put(Bytes.toBytes(split[0])); 16 put.addColumn("f1".getBytes(),"name".getBytes(),split[1].getBytes()); 17 put.addColumn("f1".getBytes(),"age".getBytes(),split[2].getBytes()); 18 context.write(new ImmutableBytesWritable(split[0].getBytes()),put); 19 } 20 } 21
启动类:
1 public static void main(String[] args) throws IOException, ClassNotFoundException, InterruptedException { 2 Configuration configuration = HBaseConfiguration.create(); 3 //设置 hbase zk 地址 4 configuration.set("hbase.zookeeper.quorum","hadoop102:2181,hadoop103:2181,hadoop104:2181"); 5 Job job = Job.getInstance(configuration); 6 job.setJarByClass(Hdfs2HbaseMR.class); 7 //输入文件路径 8 FileInputFormat.addInputPath(job,new Path("hdfs://hadoop102:9000/hbase/input")); 9 job.setMapperClass(HdfsMapper.class); 10 job.setMapOutputKeyClass(Text.class); 11 job.setMapOutputValueClass(NullWritable.class); 12 //指定输出到 Hbase 的 表名 13 TableMapReduceUtil.initTableReducerJob("user2",HBASEReducer.class,job); 14 //设置 reduce 个数 15 job.setNumReduceTasks(1); 16 boolean b = job.waitForCompletion(true); 17 System.exit(b?0:1); 18 }
03 HDFS 大数据导入Hbase
思路:与 2 中的数据导入不同的是这次的数据量比较大,使用常规的 MR 可能耗时非常的长,并且一直占用资源。
我们可以先将 Hadoop 上存储的 HDFS 文件转换成 HFile 文件,HFile 文件就是 Hbase 底层存储的类型,转换完成后,再将转换好的 HFile 文件指定给对应的 Hbase 表即可。这就是 bulkload 的方式批量加载数据,大致流程如下:
注意:
由于是文件类型转换,不做计算操作,所以只需要读入的 Mapper 操作,,不需要Reduce操作;
文件类型转换后 还需要做 Hbase 表与 HFile 文件的映射
准备工作:
准备 HDFS 上数据 ;
准备 user2 表,创建列族 f1,作为输出表。
主要代码:
Mapper 端,使用常规 Mapper
1 public class Hdfs2HFileMapper extends Mapper<LongWritable,Text,ImmutableBytesWritable,Put> { 2 @Override 3 protected void map(LongWritable key, Text value, Context context) throws IOException, InterruptedException { 4 String[] split = value.toString().split("\t"); 5 //封装输出类型 6 Put put = new Put(split[0].getBytes()); 7 put.addColumn("f1".getBytes(),"name".getBytes(),split[1].getBytes()); 8 put.addColumn("f1".getBytes(),"age".getBytes(),split[2].getBytes()); 9 // 将封装好的put对象输出,rowkey 使用 immutableBytesWritable 10 context.write(new ImmutableBytesWritable(Bytes.toBytes(split[0])),put); 11 } 12 }
启动类:
1 /** 2 * 3 * 将HDFS文件写成Hfile格式输出 4 */ 5 public class Hdfs2HileOut extends Configured implements Tool { 6 7 public static void main(String[] args) throws Exception { 8 Configuration configuration = HBaseConfiguration.create(); 9 configuration.set("hbase.zookeeper.quorum","hadoop102:2181,hadoop103:2181,hadoop104:2181"); 10 int run = ToolRunner.run(configuration, new Hdfs2HileOut(), args); 11 System.exit(run); 12 } 13 @Override 14 public int run(String[] strings) throws Exception { 15 Configuration conf = super.getConf(); 16 Job job = Job.getInstance(conf); 17 job.setJarByClass(Hdfs2HileOut.class); 18 FileInputFormat.addInputPath(job,new Path("hdfs://hadoop102:9000/hbase/input")); 19 20 job.setMapperClass(Hdfs2HFileMapper.class); 21 job.setMapOutputKeyClass(ImmutableBytesWritable.class); 22 job.setMapOutputValueClass(Put.class); 23 Connection connection = ConnectionFactory.createConnection(conf); 24 Table table = connection.getTable(TableName.valueOf("user2")); 25 //使MR可以向user2表中,增量增加数据 26 HFileOutputFormat2.configureIncrementalLoad(job,table,connection.getRegionLocator(TableName.valueOf("user2"))); 27 //数据写回到HDFS 写成HFILE -》 所以指定输出格式为Hfile 28 job.setOutputFormatClass(HFileOutputFormat2.class); 29 //HFile 输出的路径,用于与表映射的输入参数 30 HFileOutputFormat2.setOutputPath(job,new Path("hdfs://hadoop102:9000/hbase/out_hfile2")); 31 //开始执行 32 boolean b = job.waitForCompletion(true); 33 return b? 0: 1; 34 } 35 }
加载类:
public class LoadHFile2Hbase { public static void main(String[] args) throws Exception { Configuration configuration = HBaseConfiguration.create(); configuration.set("hbase.zookeeper.quorum","hadoop102:2181,hadoop103:2181,hadoop104:2181"); //获取数据库连接 Connection connection = ConnectionFactory.createConnection(configuration); Table table = connection.getTable(TableName.valueOf("user2")); //构建 LoadIncrementalHfiles 加载 Hfile文件 LoadIncrementalHFiles loadIncrementalHFiles = new LoadIncrementalHFiles(configuration); // 加载上一步输出的HFile 与表做映射 loadIncrementalHFiles.doBulkLoad(new Path("hdfs://hadoop102:9000/hbase/out_hfile2"),connection.getAdmin(),table,connection.getRegionLocator(TableName.valueOf("user2"))); } }
至此,HDFS 数据迁移至 Hbase 完成。
2 Hbase 与 Hive 集成
hbase 与 hive 相关的数据迁移工作分为两种:
-
hive 表结果 ---> hbase 表
-
hbase 表数据 ---> hive 表
这部分操作没有代码,在 hive 和 hbase 客户端就能完成操作
01 准备工作
1 首先需要将 Hbase下的5个包拷贝到 hive lib 下,建议使用软连接的形式:
ln -s /home/hadoop/module/hbase-1.2.0-cdh5.14.2/lib/hbase-client-1.2.0-cdh5.14.2.jar /home/hadoop/module/hive-1.1.0-cdh5.14.2/lib/hbase-client-1.2.0-cdh5.14.2.jar ln -s /home/hadoop/module/hbase-1.2.0-cdh5.14.2/lib/hbase-hadoop2-compat-1.2.0-cdh5.14.2.jar /home/hadoop/module/hive-1.1.0-cdh5.14.2/lib/hbase-hadoop2-compat-1.2.0-cdh5.14.2.jar ln -s home/hadoop/module/hbase-1.2.0-cdh5.14.2/lib/hbase-hadoop-compat-1.2.0-cdh5.14.2.jar /home/hadoop/module/hive-1.1.0-cdh5.14.2/lib/hbase-hadoop-compat-1.2.0-cdh5.14.2.jar ln -s home/hadoop/module/hbase-1.2.0-cdh5.14.2/lib/hbase-it-1.2.0-cdh5.14.2.jar /home/hadoop/module/hive-1.1.0-cdh5.14.2/lib/hbase-it-1.2.0-cdh5.14.2.jar ln -s home/hadoop/module/hbase-1.2.0-cdh5.14.2/lib/hbase-server-1.2.0-cdh5.14.2.jar /home/hadoop/module/hive-1.1.0-cdh5.14.2/lib/hbase-server-1.2.0-cdh5.14.2.jar
2 修改 Hive 的配置文件 hive-site.xml 添加自己的 zk 信息:
<property> <name>hive.zookeeper.quorum</name> <value>hadoop102,hadoop103,hadoop104</value> </property> <property> <name>hbase.zookeeper.quorum</name> <value>hadoop102,hadoop103,hadoop104</value> </property>
3 修改 Hive 的配置文件 hive-env.sh 添加如下信息:
export HADOOP_HOME=/kkb/install/hadoop-2.6.0-cdh5.14.2/ export HBASE_HOME=/kkb/install/servers/hbase-1.2.0-cdh5.14.2 export HIVE_CONF_DIR=/kkb/install/hive-1.1.0-cdh5.14.2/conf
至此 准备工作完成。
02 hive表导入hbase
hive 中创建管理表(内部表)与hbase 表完成映射则hive管理表的数据会添加到 hbase 表中 ,命令如下:
create table course.hbase_score(id int,cname string,score int) stored by 'org.apache.hadoop.hive.hbase.HBaseStorageHandler' with serdeproperties("hbase.columns.mapping" = "cf:name,cf:score") tblproperties("hbase.table.name" = "hbase_score");
从命令中可以看出 hbase.table.name 是指的 hbase 表名,hbase.columns.mapping 则值的对应列族下的字段,而 hive 表的 id 则会作为hbase表的 rowkey 进行存储。
通过向内部表插入数据即可完成数据查询结果的导入。
insert overwrite table course.hbase_score select id,cname,score from course.score;
最后查看 hbase 表即可看到数据。
03 hbase表导入hive
hbase 结果映射到 hive表比较简单,创建 hive 外部表即可:
CREATE external TABLE hbase2hive(id int, name string, score int) STORED BY 'org.apache.hadoop.hive.hbase.HBaseStorageHandler' WITH SERDEPROPERTIES ("hbase.columns.mapping" = ":key,cf:name,cf:score") TBLPROPERTIES("hbase.table.name" ="hbase_hive_score");
从命令中可以看出 hbase.table.name 是指的 hbase 表名,hbase.columns.mapping 的值则对应hive表的字段,而 hive 表的 id 则会作取 hbase表的 rowkey 进行存储。
至此,Hbase 与 Hive 的数据迁移就完成了。
3 Hbase 协处理器和基础 api
关于基础api这部分比较详细的介绍就在代码中了,再此我们就简单说一下Hbase 协处理器。
协处理器是为了解决Hbase早期版本的一些问题,如建立二次索引、复杂过滤器、求和计数分组计数等类sql操作以及访问控制等。
Hbase 提供两类协处理器:
-
observer 类似数据库的触发器,个人理解类似拦截器的功能;
-
endpoint 类似数据库的存储过程,可以实现类sql的统计操作。
协处理器的加载方式
01 静态加载实现
通过修改 hbase-site.xml 这个文件来实现, 如启动全局 aggregation,能过操纵所有的表数据。只需要在hbase-site.xml里面添加以下配置即可,修改完配置之后需要重启HBase集群。
<property> <name>hbase.coprocessor.user.region.classes</name> <value>org.apache.hadoop.hbase.coprocessor.AggregateImplementation</value> </property>
为所有table加载了一个 cp class,可以用” ,”分割加载多个 class。
02 动态加载实现
启用表aggregation,只对特定的表生效。
下面以协处理器 observer 为例来简单说下操作过程:
1 创建 两张 hbase 表,user1 ,user2:
create 'user1','info; create 'user2','info';
2 协处理器代码开发,完成往 user1 表插入数据时,先往 user2 表插入数据,代码如下:
1 public class MyProcessor extends BaseRegionObserver { 2 @Override 3 public void prePut(ObserverContext<RegionCoprocessorEnvironment> e, Put put, WALEdit edit, Durability durability) throws IOException { 4 //获取连接 5 Configuration configuration = HBaseConfiguration.create(); 6 configuration.set("hbase.zookeeper.quorum","hadoop102:2181,hadoop103:2181:hadoop104:2181"); 7 Connection connection = ConnectionFactory.createConnection(configuration); 8 //涉及多个版本得问题 9 List<Cell> cells = put.get("info".getBytes(), "name".getBytes()); 10 //将user1表的name 数据也插入到 user2 中 11 Cell nameCell = cells.get(0); 12 Put put1 = new Put(put.getRow()); 13 put1.add(nameCell); 14 Table table = connection.getTable(TableName.valueOf("user2")); 15 table.put(put1); 16 table.close(); 17 connection.close(); 18 } 19 }
3 将开发好的项目打包上传到 HDFS ,路径自定,假设是:
hdfs://hadoop102:9000/processor/processor.jar
4 将 jar 包挂载到 user1 表:
disable 'user1'; alter 'user1',METHOD => 'table_att','Coprocessor'=>'hdfs://hadoop102:9000/processor/processor.jar|com.bigdata.comprocessor.MyProcessor|1001|'; enabled 'user1';
com.bigdata.comprocessor.MyProcessor : 你程序的全类名;
1001 :协处理器编号,自定义即可,表中协处理器的编号不能重复。
5 测试向 user1 中插入数据,user2 是否有数据:
1 public class TestObserver { 2 3 @Test 4 public void testPut() throws IOException { 5 6 //获取连接 7 Configuration configuration = HBaseConfiguration.create(); 8 configuration.set("hbase.zookeeper.quorum", "hadoop102:2181,hadoop103:2181,hadoop104:2181"); 9 //创建连接对象 10 Connection connection = ConnectionFactory.createConnection(configuration); 11 Table proc1 = connection.getTable(TableName.valueOf("user1")); 12 Put put = new Put("1110001112".getBytes()); 13 14 put.addColumn("info".getBytes(),"name".getBytes(),"hello".getBytes()); 15 put.addColumn("info".getBytes(),"gender".getBytes(),"male".getBytes()); 16 put.addColumn("info".getBytes(),"nationality".getBytes(),"test".getBytes()); 17 proc1.put(put); 18 proc1.close(); 19 connection.close(); 20 System.out.println("success"); 21 22 } 23 }
关于协处理器卸载:
disable 'user1' alter 'user1',METHOD=>'table_att_unset',NAME=>'coprocessor$1' enable 'user1'
协处理器 observer 大致开发流程就是这样的。关于基础 api 放在参考资料的项目中了。
至此,还留有一个问题就是 hbase 的 endpoint 协处理器,其实它解决的问题及时实现 min、 max、 avg、 sum、 distinct、 group by 等sql功能,这个问题我们放在下期,下期介绍一个基于 hbase 框架之上的框架 -- phoenix,Phoenix之于 Hbase ,就像 hive 之于 Hadoop,会完美的实现 hbase 的 sql 查询操作。
项目代码地址: https://github.com/fanpengyi/hbase-api
-- THE END --