HBase数据迁移实践操作篇

Posted 2021-04-19 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 ;

恢复快照(hbase用户执行)

hbase>list_snapshots hase>restore_snapshot 'snapshot_name'

检查快照恢复后的表是否可用 
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>

原集群

6.修改原集群的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>

7.添加新集群IP和主机名映射

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

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

snapshot 'tablename','tablename_sp_20170821112930'

9.从老集群导出快照到新集群

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 实际数据文件目录

5.导出快照目录路径问题

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

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

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

6.快照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 重新执行

7.恢复权限时候报错

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

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

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

9.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/)。

长按下面的二维码关注HBase技术社区

长按下面的二维码邀请加入HBase社区微信群