HBase 数据迁移

最近两年负责 HBase，经常被问到一些问题， 本着吸引一些粉丝、普及一点HBase 知识、服务一点阅读人群的目的，就先从 HBase 日常使用写起，后续逐渐深入数据设计、集群规划、性能调优、内核源码级解析、思考。

数据迁移是 HBase 常见操作需求之一，本文将介绍 HBase 常用的大数据量数据迁移常见的两种方法：

  • 1、DSTCP+ FIX 元数据信息

  • 2、SNAPSHOT 快照导出迁移

DISTCP迁移

DISTCP的思路是，直接通过DISTCP拷贝HBase 的目录文件到目标集群，
然后在目标集群通过hbase提供的hbck 工具来执行元数据修复

案例：

　　 0.94.11 版本迁移到1.1.3，0.94.11 版本是2013年的版本，是非常老的一个版本。社区从0.96版本开始 HBase 序列化协议和目录结构发生了变化 0.96后的版本不需要步骤2、3

解决步骤： 确保网络互通，两个集群的 /etc/hosts 配置主机名映射

如下所在步骤在新集群操作

　　1、distcp 拷贝表目录 
　　2、创建表描述文件目录（0.96之后版本不需要） 
　　3、移动表描述文件到如上目录(0.96之后版本不需要） 
　　4、修改权限 
　　5、修改所属用户 
　　6、修复表 执行hbase hbck -fixMeta -fixAssignments 
　　7、登陆hbase shell 执行describe/count/scan 操作验证 
　　数据量大的表建议使用hbase提供的MR RowCounter 工具进行统计： hbase org.apache.hadoop.hbase.mapreduce.RowCounter ‘testTable’

　　1-5 步骤使用hdfs 用户执行命令：

　　hadoop distcp hftp://original_namenode1:port/hbase/test hdfs://new_namenode:8020/apps/hbase/data/data/default/
　　hdfs dfs -mkdir /apps/hbase/data/data/default/test/.tabledesc
　　hdfs dfs -mv /apps/hbase/data/data/default/test/.tableinfo.0000000001 /apps/hbase/data/data/default/test/.tabledesc/
　　hdfs dfs -chmod -R 755 /apps/hbase/data/data/default/test
　　hdfs dfs -chown -R hbase:hdfs /apps/hbase/data/data/default/test

　　6-7 切换到hbase 用户执行：

　　hbase hbck -fixMeta  -fixAssignments test

SNAPSHOT快照迁移

HBase 支持快照功能以及快照导出功能，组合利用此功能可以实现数据迁移。

总体思路：

　　1、启用快照配置 
　　2、原集群执行快照，然后执行ExportSnapshot 导出到老集群。注意权限问题。 
　　3、导出后，修改对应的权限，然后执行恢复即可

注意点：

　　1、注意文件目录权限 
　　2、注意配置各自的hostname和IP映射 
　　3、注意压缩库是否都配置了

新集群：

　　1）检查新老集群配置snappy压缩支持(可选，因为有些新老集群压缩不一定支持） 
　　在hbase-env.sh中添加如下属性：

　　export JAVA_LIBRARY_PATH=/usr/lib/hadoop/lib/native/Linux-amd64-64:/usr/lib/hadoop/lib/native

　　默认加载hadoop的native类库。

　　2）检查是否启用快照 
　　hbase-site.xml中添加 hbase.snapshot.enabled为true

　　3）检查快照和压缩可用性（hbase 用户执行） 
　　（注意本步骤必不可少，即使知道快照和压缩已经可用，因为需要此步骤来自动生成 /apps/hbase/data/.hbase-snapshot 目录）

　　su - hbase
　　hbase>create 'test_tmp_2017', {NAME => 'F', DATA_BLOCK_ENCODING => 'NONE', BLOOMFILTER => 'ROW',COMPRESSION => 'SNAPPY'}hbase>flush ’test_tmp_2017'
　　hbase>snapshot ’test_tmp_2017', ’test_tmp_2017_sp'
　　hbase>list_snapshots
　　hbase>delete_snapshot ’test_tmp_2017_sp'

　　4）修改新集群快照目录权限（hdfs用户执行） 
　　原集群为olduser用户，执行快照导出的时候，由于没有权限会导致导入失败。 
　　导出快照前，需要执行如下权限：

　　su - hdfs
　　hdfs dfs -chmod -R 777 /apps/hbase/data/.hbase-snapshot ;hdfs dfs -chmod -R 777 /apps/hbase/data/archive ;

　　如下步骤发生到老集群导入后：

　　5）修改导出快照文件和信息的权限(hbase:hdfs) 
　　导入后为olduser用户权限，需要修改如下

　　hdfs dfs -chmod -R 755 /apps/hbase/data/.hbase-snapshot;hdfs dfs -chmod -R 755 /apps/hbase/data/archive ;hdfs dfs -chown -R hbase:hadoop /apps/hbase/data/.hbase-snapshot;hdfs dfs -chown -R hbase:hadoop /apps/hbase/data/archive ;

　　6）恢复快照(hbase用户执行）

　　hbase>list_snapshots
　　hase>restore_snapshot 'snapshot_name'

　　7）检查快照恢复后的表是否可用 
　　　　(a)先简单 hbase> scan ‘tablename’,{LIMIT => 10} 
　　　　(b)后面再使用 hbase canary扫描全部的表 
　　　　(c)统计行数

　　su - hdfs
　　hdfs dfs -mkdir -p /user/hbase;hdfs dfs -chown -R hbase:hdfs /user/hbase;su - hbaseexport HADOOP_HOME=/usr/lib/hadoop;export HBASE_HOME=/usr/lib/hbase;export HADOOP_CLASSPATH=`${HBASE_HOME}/bin/hbase classpath`; ${HADOOP_HOME}/bin/hadoop jar /usr/lib/hbase/lib/hbase-server-1.1.3.jar rowcounter <tableName>

　　原集群

　　8）修改原集群的hbase.rootdir配置，在NameNode HA的情况下，原来的hbase.rootdir配置写的有问题，不需要nameservice 不需要端口

　　<property><name>hbase.rootdir</name><value>hdfs://cluster1:8020/hbase</value></property>

　　修改为

　　<property><name>hbase.rootdir</name><value>hdfs://cluster1/hbase</value></property>

　　9）添加新集群IP和主机名映射

　　将新集群的/etc/hosts中主机名和IP映射添加到老集群所有节点。（ExportSnapshot MR要用到）

　　10）对所有需要的历史表执行快照，快照命名规则为tablename_sp_YYYYMMDDHHMMmm

　　snapshot 'tablename','tablename_sp_20170821112930'

　　11）从老集群导出快照到新集群

　　hbase>flush 'tablename'hbase --config /usr/lib/hadoop/etc/hadoop:/usr/lib/hbase/conf/ org.apache.hadoop.hbase.snapshot.ExportSnapshot -snapshot {snapshotname} -copy-to{hbase.rootdir}

　　第一个参数为快照名称，第二个参数为新集群中hbase-site.xml中配置的hbase根目录 
　　备注： 如果exportSnapshot执行失败，则需要在新集群删除

　　hdfs dfs -rm -r /apps/hbase/data/.hbase-snapshot/.tmp/snapshotname

　　删除对应的临时目录

被人问过以及一些常见可能的错误：

1、执行 ExportSnapshot 报 Wrong FS错误 
　　NN HA不需要加端口，只需要dfs.nameservices

　 hbase --config /usr/lib/hadoop/etc/hadoop:/usr/lib/hbase/conf/ org.apache.hadoop.hbase.snapshot.ExportSnapshot -snapshot test_export -copy-to file:///home/old_user

Exception in thread “main” java.lang.IllegalArgumentException: Wrong FS: hdfs://cluster1:8020/hbase/.hbase-snapshot/test_export/.snapshotinfo, expected: hdfs://cluster1

　<property><namehbase.rootdir></name><value>hdfs://cluster1:8020/hbase</value></property>

　　修改为

  <property><name>hbase.rootdir</name><value>hdfs://cluster1/hbase</value></property>

2、执行快速结束了，没有MR信息

Exception in thread “main” org.apache.hadoop.hbase.snapshot.ExportSnapshotException: Failed to copy the snapshot directory: from=hdfs://cluster1/hbase/.hbase-snapshot/test_snapshot to=hdfs://new_cluster:8020/tmp/export/.hbase-snapshot/.tmp/test_snapshot at org.apache.hadoop.hbase.snapshot.ExportSnapshot.run(ExportSnapshot.java:742) at org.apache.hadoop.util.ToolRunner.run(ToolRunner.java:70 at org.apache.hadoop.hbase.snapshot.ExportSnapshot.innerMain(ExportSnapshot.java:800) at org.apache.hadoop.hbase.snapshot.ExportSnapshot.main(ExportSnapshot.java:804)

　　原因是导出新集群的目录没有权限（此处并没有报出错误信息）

　hdfs dfs -chmod 777 /tmp/export

3、UnknownHostException

17/08/18 16:14:51 INFO mapreduce.Job: Task Id : attempt_1503041014815_0006_m_000000_0, Status : FAILED Error: java.lang.IllegalArgumentException: java.net.UnknownHostException: new_cluster at org.apache.hadoop.security.SecurityUtil.buildTokenService(SecurityUtil.java:377) at org.apache.hadoop.hdfs.NameNodeProxies.createNonHAProxy(NameNodeProxies.java:237) at org.apache.hadoop.hdfs.NameNodeProxies.createProxy(NameNodeProxies.java:141) at org.apache.hadoop.hdfs.DFSClient.(DFSClient.java:576) at org.apache.hadoop.hdfs.DFSClient.(DFSClient.java:521) at org.apache.hadoop.hdfs.DistributedFileSystem.initialize(DistributedFileSystem.java:146) at org.apache.hadoop.fs.FileSystem.get(FileSystem.java:368) at org.apache.hadoop.hbase.snapshot.ExportSnapshot$ExportMapper.setup(ExportSnapshot.java:142) .... Caused by: java.net.UnknownHostException: new_cluster

　　将新集群的IP和主机名 添加到原集群中。

4、导入失败

Exception in thread “main” org.apache.hadoop.hbase.snapshot.ExportSnapshotException: Failed to copy the snapshot directory: from=hdfs://cluster1/hbase/.hbase-snapshot/test_snapshot to=hdfs://new_cluster:8020/apps/hbase/data/.hbase-snapshot/.tmp/test_snapshot at org.apache.hadoop.hbase.snapshot.ExportSnapshot.run (ExportSnapshot.java:742) at org.apache.hadoop.util.ToolRunner.run(ToolRunner.java:70) at org.apache.hadoop.hbase.snapshot.ExportSnapshot.innerMain(ExportSnapshot.java:800) at org.apache.hadoop.hbase.snapshot.ExportSnapshot.main(ExportSnapshot.java:804)

　　原来的老集群的用户old_user没有权限，导入新集群(hbase:hdfs)

　　chmod 777 /apps/hbase/data/.hbase-snapshot snapshot描述信息目录

　　chmod 777 /apps/hbase/data/archive 实际数据文件目录

4、导出快照目录路径问题

　　导出快照的路径不是随便写的，不然目的集群找不到快照名称。

　　路径应该为新集群的hbase.rootdir

　　导入的快照会在hbase.rootdir/.hbase-snapshot 中，该目录刚开始是没有的，需要在新集群，随便生生个表，然后执行一次快照即会出现。

5、快照 may be in-progress

A snapshot with the same name ‘test_snapshot’ may be in-progress Please check hdfs://new_cluster:8020/apps/hbase/data/.hbase-snapshot/.tmp/test_snapshot. If the snapshot has completed, consider removing hdfs://new_cluster:8020/apps/hbase/data/.hbase-snapshot/.tmp/test_snapshot before retrying export

　　原因是上次导出快照失败后，仍然会残留信息 
　　删除新集群的/apps/hbase/data/.hbase-snapshot/.tmp/test_snapshot 重新执行

6、恢复权限时候报错：

Caused by: org.apache.hadoop.ipc.RemoteException(org.apache.hadoop.security.AccessControlException): Permission denied: user=hbase, access=WRITE, inode=”/apps/hbase/data/archive/data/default/test/55920779ef2f781d7b1195862a81e7b9/c1/.links-6186277fd0e14bcb98020b41437580fc”:e3base:hdfs:drwxr-xr-x

　　导入的时候，是使用导入用户的权限。需要授权 
7、snappy 报错 
　　配置snappy压缩支持： 
　　在HC的hbase-env.sh中添加如下属性：

　export JAVA_LIBRARY_PATH=/usr/lib/hadoop/lib/native/Linux-amd64-64:/usr/lib/hadoop/lib/native

8、ClassNotFoundException：

java.lang.ClassNotFoundException：org.apache.hbadoop.hbase.codec.prefixetree.PrefixTreeCodec….

　　yarn-site.xml中的yarn.application.classpath 添加hbase /lib 目录路径 
　　mapred-site.xml中的mapreduce.application.classpath 添加hbase /lib 目录路径 
　　尝试使用类似如下命令去执行hbase MR

　export HADOOP_HOME=/usr/lib/hadoop;export HBASE_HOME=/usr/lib/hbase;export HADOOP_CLASSPATH=`${HBASE_HOME}/bin/hbase classpath`; ${HADOOP_HOME}/bin/hadoop jar /usr/lib/hbase/lib/hbase-server-1.1.3.jar rowcounter testtable

 

　　注意线上环境执行distcp或者snapshot 需要限制带宽。可通过设置map数以及限制每个map的带宽来实现。

　　限制带宽方法请执行如下命令查看帮助

　hadoop distcp

-bandwidth Specify bandwidth per map in MB 
-m Max number of concurrent maps to use for copy

　hbase org.apache.hadoop.hbase.snapshot.ExportSnapshot

-mappers Number of mappers to use during the copy (mapreduce.job.maps).
-bandwidth Limit bandwidth to this value in MB/second.

　本文属于部分码农喜闻乐见的实践操作篇。如果你对 HBase 数据迁移有需求，那么可以直接拿过去用即可。有想了解 HBase 相关内容，也可以给我留言交流。有时间我会写博客来回答，也可以在 http://hbase-help.com/ 来交流，我的ID 是 hmaster 。(有感于 HBase 远没有 MySQL 等 RDBMS 那么普及，也没有好的交流平台， 微信群又只能 500 人，故推荐一下这个 HBase 技术社区交流网站  http://hbase-help.com/）

转自：https://mp.weixin.qq.com/s/ECscnnfWi71k6tlA35v1iA
​

交流

如果大家对HBase有兴趣，致力于使用HBase解决实际的问题，欢迎加入Hbase技术社区群交流：

社区问答：http://hbase.group

微信公众号：HBase技术社区

​钉钉HBase技术社区群，扫描以下二维码:

 

 

​  钉钉HBase技术社区群

 

 

posted on 2018-04-09 13:30  HBase技术社区  阅读(1397)  评论(0)  编辑  收藏  举报
Copyright © 2024 HBase技术社区
Powered by .NET 9.0 on Kubernetes Powered by: 博客园