在 Debian 上的 HBase 数据恢复实战指南
一 恢复前准备与故障定位
- 备份当前状态：在操作前先备份 HBase 根目录与 HDFS 上的表目录，避免二次损坏。示例（Debian 路径示例，按实际调整）：
- 本地文件系统（若使用本地存储）：
sudo cp -a /opt/hbase/data /opt/hbase/data_backup_$(date +%F)
- HDFS 表目录：
hdfs dfs -cp -r /hbase/data/default/your_table /hbase/backup/your_table_$(date +%F)
- 检查集群与健康：确认 ZooKeeper 正常，尝试启动 HBase 并观察进程与日志。
- 启动：
/opt/hbase/bin/start-hbase.sh
- 日志：
tail -f /opt/hbase/logs/hbase-*.log
- 一致性检查：使用 hbck 评估表/Region 健康度，必要时再执行修复。
- 检查：
/opt/hbase/bin/hbase hbck
- 修复（谨慎）：
/opt/hbase/bin/hbase hbck -repair
- 故障类型速览与首选动作：
- HMaster 宕机：确保 ZooKeeper 正常后重启 HMaster。
- RegionServer 宕机：确保 ZooKeeper 正常后重启 RegionServer。
- 数据文件损坏/不一致：先
hbck 评估，再 -repair 修复。
- 配置错误：修正
hbase-site.xml 后重启集群。
二 常用恢复方法与步骤
- 快照恢复（时间点恢复，优先选择）
- 列出快照：
/opt/hbase/bin/hbase shell → list_snapshots
- 若表被删，先按原结构重建表（列族一致）。
- 恢复：
restore_snapshot 'snapshot_name'
- 校验：
scan 'your_table', LIMIT => 10
- 备份与还原（全量/增量，适合跨集群/跨版本迁移）
- 全量备份：
/opt/hbase/bin/hbase backup create full -t your_table -n backup_20251127
- 增量备份：
/opt/hbase/bin/hbase backup create incremental -t your_table -n incr_20251127
- 还原：
/opt/hbase/bin/hbase restore -t your_table -n backup_20251127 [-s backup_id]
- WAL 回放（异常关闭/数据未落盘场景）
- 适用：宕机或异常关闭后，Region 未正常关闭，需要重放 WAL 以找回未持久化数据。
- 要点：HBase 在 Region 启动时通常会自动回放 WAL；若需手动介入，需按表/Region 定位 WAL 文件并在维护窗口内执行，操作前务必做好备份。
- HFile 离线导出（文件级恢复/迁移）
- 适用：HFile 仍在 DFS 上但元数据丢失或需迁移到新表/新集群。
- 思路：使用 HBase 提供的 Export/Import 工具或自定义 MR 作业，将 HFile 导入目标表（需目标表预建且列族一致）。
- hbck 修复（一致性修复）
- 流程：
hbck 识别不一致 → 视情况执行 hbck -repair；修复前建议备份并评估影响范围，生产环境谨慎执行。
三 典型场景与命令清单
- 场景 A：误删表后按快照恢复
- 重建表结构（与快照一致）→
restore_snapshot 'snap_20251127'
- 场景 B：RegionServer 宕机导致部分数据不可用
- 确认 ZooKeeper 正常 → 重启 RegionServer →
hbck 检查 → 必要时 -repair
- 场景 C：异常关闭后数据疑似未落盘
- 重启集群观察自动 WAL 回放 → 若异常，进入维护模式，按表/Region 定位 WAL 并回放
- 场景 D：HFile 仍在但元数据异常
- 使用 Export/Import 将 HFile 导入新表或新集群，完成数据挽救
四 验证与注意事项
- 恢复后验证
- 集群状态：
/opt/hbase/bin/hbase shell → status 'simple'
- 数据抽样：
scan 'your_table', {LIMIT => 100}
- 关键业务校验：行数、重要 Key 是否存在、列族覆盖是否完整
- 注意事项
- 操作前务必对现有 HBase 目录与 HDFS 数据做备份，避免二次损坏。
- 恢复期间可能需 禁用表 或短暂中断业务，建议在低峰期执行。
- 快照/备份与当前 HBase 版本尽量保持一致，减少兼容性问题。
- 修复类操作（如
hbck -repair）具有风险，先评估、再小范围验证，最后再全量执行。