HBase数据恢复Debian技巧

Debian环境下HBase数据恢复实用技巧

一、先判断场景与优先级

• 误删了部分数据但表还在：优先尝试从“已删除但未物理清理”的墓碑标记中抢救，立刻降低进一步丢失的风险。
• disable + drop 删除了表：检查 HDFS 回收站与 HBase 归档目录 archive，很多情况下数据仍在，可快速回灌。
• 集群异常或文件损坏：用 hbck 做一致性检查与修复，结合日志定位故障组件再恢复。
• 有备份或快照：直接用快照/导出导入恢复，这是最稳妥的路径。

二、场景化恢复步骤

• 场景A 误删行/列但未删表（抢救窗口期）

  1. 立刻在 hbase shell 为涉及的列族开启保留已删除单元：
     alter ‘t’, { NAME => ‘f’, KEEP_DELETED_CELLS => TRUE }
     若有多个列族，逐一设置。注意：开启后数据仍会按 TTL 过期被清理。
  2. 用 raw 扫描定位被删数据：
     scan ‘t’, { RAW => true, TIMERANGE => [0, 目标时间上限] }
     在结果中你会看到 type=Delete 的墓碑与对应的旧值，按业务主键与时间戳筛选需要回灌的记录。
  3. 将筛选结果写回（批量 Put/Mutation）到原表或临时表，完成恢复。
  4. 校验一致性后，可按需关闭 KEEP_DELETED_CELLS（或保持开启，结合 TTL 管理存储）。
     说明：HBase 删除写入的是“删除标记”，在 major compaction 时才清理；KEEP_DELETED_CELLS 可让合并时保留旧单元，从而通过 raw 扫描找回。

• 场景B disable + drop 后表没了

  1. 立刻检查 HDFS 回收站：
     hadoop fs -ls /user/$USER/.Trash/Current/hbase/…
     若仍在，mv 回原路径（如 /hbase/data/default/表名），然后跳到第3步。
  2. 若回收站已清空，检查 HBase 归档目录：
     hadoop fs -ls /hbase/archive/data/default/
     找到被删表的目录后先拷贝到临时备份目录，避免定时清理。
  3. 在 HBase 中按原结构重建表（列族、配置保持一致）。
  4. 将归档或回收站中的表目录拷回 /hbase/data/default/表名（或按 archive 结构放置），必要时用 hbck -repair 修复元数据一致性。
  5. 在 hbase shell 执行 enable ‘表名’ 并 scan 验证。

• 场景C 集群异常/文件损坏

  1. 先停写（必要时 stop-hbase.sh），备份当前 /hbase 目录与关键配置。
  2. 查看 /hbase/logs 下 HMaster/RegionServer 日志定位异常。
  3. 使用 hbck 检测并修复：
     hbase hbck -repair
     视结果处理 region 重叠、缺失引用等问题。
  4. 重启集群并校验：
     start-hbase.sh
     hbase shell 中 status ‘simple’ 与 scan 关键表。

三、Debian系统下的操作要点

• 以 hdfs 用户或具备 HDFS 权限的用户执行回收站/归档操作，避免权限不足导致恢复失败。
• 路径因发行版与安装方式不同可能为 /hbase、/opt/hbase 等，操作前用
  hadoop fs -ls /
  确认实际根路径；Debian 上建议使用绝对路径，减少歧义。
• 任何写操作（mv/cp/Import/Export）前先备份当前状态；长时间操作可加 -Dmapreduce.job.queuename=your_queue 避免影响线上。
• 使用 raw 扫描与回灌时，注意 TIMERANGE 与 VERSIONS，避免重复写入或漏写。

四、验证与回灌建议

• 校验清单：
  • 行数/分区范围是否恢复；关键业务主键是否完整；
  • 列族与版本数是否符合预期；
  • 通过 get ‘t’, ‘rowkey’, { TIMERANGE => […], VERSIONS => N } 核对时间戳与值。
• 回灌方式：
  • 小量数据：hbase shell 逐条或批量 Put；
  • 大量数据：用 Export/Import 或 Spark/MapReduce 作业批量导入，效率更高。
• 若采用拷贝 HFile 的方式，务必保证目标表结构与 region 分布一致，再重启或执行 assign 让 Region 重新上线。

五、预防与运维建议

• 开启 HBase 快照 做定时/关键操作前快照，必要时一键回滚。
• 为易误删的列族设置 KEEP_DELETED_CELLS = true 并合理规划 TTL，在保留窗口内可快速抢救。
• 打开 HDFS 回收站：
  • fs.trash.interval（分钟）建议 4320（3天）；
  • fs.trash.checkpoint.interval 建议 60（1小时）；
    降低误删后数据不可恢复的风险。
• 实施 ACL 权限 与操作审计，限制 drop/disable 等高危操作；定期做 全量/增量备份 与异地归档。