# FixHiveMetadata工具
#### 功能说明
恢复Hive Metastore保存的Hudi表的schema，使其与Hudi表最新schema一致。修复时会同步更新主表及其关联的_ro/_rt视图表（如果存在）。
#### 命令格式
```
spark-submit \
--master yarn \
--driver-memory 2G \
--num-executors 3 \
--executor-memory 4G \
--class com.huawei.mrs.hudi.tools.FixHiveMetadata \
/opt/hudi-fix-tools-1.0.jar \
${命令} ${库名.表名}
```
#### 参数说明
| **参数**   | **是否必选** | **参数说明**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| ${命令}    | 是        | - check：检测Hive Metastore中schema是否和Hudi表最新schema一致。  - fix：备份Hive Metastore中schema并更新为与Hudi表最新schema一致（同时更新_ro/_rt表）。  - restore：对备份文件进行恢复，恢复到修复前的状态。  - cleanbackup：删除备份文件。   |
| ${库名.表名} | 是        | 需要处理的Hudi表名，格式为库名.表名。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
#### 输出结果说明
| **字段**  | **说明**                      |
|:---|:---|
| RESULT  | success表示执行成功，failed表示执行失败。 |
| MESSAGE | 检测、执行结果信息或执行失败信息。           |
   
**check命令的MESSAGE**：
| **MESSAGE**                                                     | **说明**                                |
|:---|:---|
| No problems found.                                              | Hive Metastore schema与Hudi表schema一致。  |
| The schema in hive metastore is not the same with hoodie schema | Hive Metastore schema与Hudi表schema不一致。 |
   
#### 使用样例
- 检查Hive Metastore schema是否与Hudi表schema一致：
  ```
  spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \
  --class com.huawei.mrs.hudi.tools.FixHiveMetadata \
  /opt/hudi-fix-tools-1.0.jar \
  check mydb.mytable
  ```
  
- 修复Hive Metastore schema（自动备份，同时更新_ro/_rt表）：
  ```
  spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \
  --class com.huawei.mrs.hudi.tools.FixHiveMetadata \
  /opt/hudi-fix-tools-1.0.jar \
  fix mydb.mytable
  ```
  
- 修复效果不理想，恢复到修复前状态：
  ```
  spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \
  --class com.huawei.mrs.hudi.tools.FixHiveMetadata \
  /opt/hudi-fix-tools-1.0.jar \
  restore mydb.mytable
  ```
  
- 确认修复效果后，清理备份文件：
  ```
  spark-submit --master yarn --driver-memory 2G --num-executors 3 --executor-memory 4G \
  --class com.huawei.mrs.hudi.tools.FixHiveMetadata \
  /opt/hudi-fix-tools-1.0.jar \
  cleanbackup mydb.mytable
  ```