更新时间：2026-10-28 GMT+08:00
FixHoodieMetaFile工具
功能说明
根据Hive Metastore中保存的表信息恢复丢失的hoodie.properties、hoodie.index.properties元数据文件。工具不支持备份恢复。
约束
不支持properties文件损坏或无权限等异常修复，只解决文件丢失问题。如果文件存在异常请先备份删除文件后，再使用工具进行恢复。
命令格式
spark-submit \
--master yarn \
--driver-memory 2G \
--num-executors 3 \
--executor-memory 4G \
--class com.huawei.mrs.hudi.tools.FixHoodieMetaFile \
/opt/hudi-fix-tools-1.0.jar \
${命令} ${库名.表名} [${表属性}...] 参数说明
| 参数 | 是否必选 | 参数说明 |
|---|---|---|
| ${命令} | 是 |
|
| ${库名.表名} | 是 | 需要处理的Hudi表名，格式为库名.表名。 |
| ${表属性} | 否 | 以key=value形式提供的额外表属性，用于恢复hoodie.index.properties时补充缺失的索引信息。可输入多个，格式为key1=value1 key2=value2。仅包含一个=的参数有效，key=value=extra格式会被静默忽略。 |
输出结果说明
| 字段 | 说明 |
|---|---|
| RESULT | success表示执行成功，failed表示执行失败。 |
| MESSAGE | 检测、执行结果信息或执行失败信息。 |
check命令的MESSAGE：
| MESSAGE | 说明 |
|---|---|
| No problems found. | 两个文件均存在。 |
| ERROR: The hoodie.properties file does not exist. | hoodie.properties文件缺失。 |
| ERROR: The hoodie.index.properties file does not exist. | hoodie.index.properties文件缺失。 |
| ERROR: The hoodie.properties and hoodie.index.properties does not exist. | 两个文件均缺失。 |
使用样例
- 检查元数据文件是否存在：
spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \ --class com.huawei.mrs.hudi.tools.FixHoodieMetaFile \ /opt/hudi-fix-tools-1.0.jar \ check mydb.mytable
- 恢复缺失的元数据文件（Hive Metastore中包含完整索引信息）：
spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \ --class com.huawei.mrs.hudi.tools.FixHoodieMetaFile \ /opt/hudi-fix-tools-1.0.jar \ fix mydb.mytable
- 恢复缺失的元数据文件（Hive Metastore中缺少索引信息，需手动提供）：
spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \ --class com.huawei.mrs.hudi.tools.FixHoodieMetaFile \ /opt/hudi-fix-tools-1.0.jar \ fix mydb.mytable hoodie.index.type=BUCKET hoodie.bucket.index.num.buckets=4
父主题： Hudi修复工具使用指导
