# 恢复ClickHouse元数据
#### 操作场景
在用户意外修改、删除或需要找回数据时，集群用户需要对ClickHouse进行重大操作（如升级或迁移等）后，系统数据出现异常或未达到预期结果，导致ClickHouse组件全部故障无法使用，或者迁移数据到新集群的场景中，需要对ClickHouse元数据进行恢复数据操作。
集群用户可以通过FusionInsight Manager创建恢复ClickHouse元数据任务，系统仅支持手动进行数据恢复。
MRS集群支持多种数据路径类型恢复ClickHouse元数据：
- LocalDir：表示从主管理节点的本地磁盘上恢复数据。
- RemoteHDFS：表示从备集群的HDFS目录恢复数据。
- OBS：表示从OBS中恢复数据。
 
![](https://support.huaweicloud.com/usermanual-mrs/public_sys-resources/note_3.0-zh-cn.png)
当业务正常时需要恢复ClickHouse元数据，建议手动备份最新ClickHouse元数据后，再执行恢复ClickHouse元数据操作。否则会丢失从备份时刻到恢复时刻之间的ClickHouse元数据。
#### 约束与限制
- MRS 3.1.0及之后版本支持该功能。
- 只支持进行数据备份时的系统版本与当前系统版本一致时的数据恢复。
- ClickHouse元数据恢复和业务数据恢复不能同时进行操作，否则会导致业务数据恢复失败。建议元数据恢复完成后再进行业务数据恢复。
- MRS 3.3.0及之后版本支持从OBS中恢复数据。
 
#### 对系统的影响
- 元数据恢复后，会丢失从备份时刻到恢复时刻之间的数据。
- 元数据恢复后，需要重新启动ClickHouse的上层应用。
 
#### 前提条件
- 检查ClickHouse元数据备份文件保存路径。
- 如果需要从远端HDFS恢复数据，需要准备备集群，且已完成数据备份，详细操作请参见[备份ClickHouse元数据](https://support.huaweicloud.com/usermanual-mrs/admin_guide_000348.html)。如果主备集群部署为安全模式，且主备集群不是由同一个FusionInsight Manager管理，则必须配置系统互信，请参见[配置MRS集群间互信](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0354.html)。如果主备集群部署为普通模式，则不需要配置互信。
- 主备集群中，从远端HDFS恢复至本地时，需要确保ClickHouse的"HADOOP_RPC_PROTECTION"配置项与HDFS的"hadoop.rpc.protection"配置项的值保持一致。
- 若待恢复数据非本集群数据，待恢复数据为MRS其他ClickHouse集群的备份数据，还需要满足如下要求：
  1. 备份数据集群与待恢复集群MRS版本一致。
  
  2. 备份数据集群与待恢复集群模式一致。
  
  3. 备份数据集群与待恢复集群ClickHouse拓扑一致，包括shard、副本。
   
 
#### 恢复ClickHouse元数据
1. 登录MRS集群Manager界面。 
   登录集群Manager界面请参考[访问MRS集群Manager](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0128.html)。
   
   
2. 选择 "运维 \> 备份恢复 \> 备份管理"。
3. 在任务列表指定任务的"操作"列，选择"更多 \> 查询历史"。
   
   在弹出的窗口中，指定一次成功执行的"备份路径"，单击"查看"，打开此次任务执行的备份路径信息，查找以下信息：
   - "备份对象"表示备份的数据源。
   
   - "备份路径"表示备份文件保存的完整路径。 选择正确的项目，在"备份路径"中选中备份文件的完整路径并复制。
     
   
   
   
   
4. 选择"运维 \> 备份恢复 \> 恢复管理"。
5. 单击"创建"。
6. 在"任务名称"填写恢复任务的名称。
7. 在"恢复对象"选择待操作的集群。
8. 在"恢复配置"，勾选"元数据和其他数据"下的"ClickHouse"。
9. 在"ClickHouse"的"路径类型"，选择一个备份目录的类型。 
   表1恢复数据 
   | 路径类型       | 配置参数             | 参数说明                                                                                                                                                                                       |
   |:---|:---|:---|
   | LocalDir   | 源端路径             | 要恢复的备份文件，具体需要登录主OMS所在节点，进入[步骤 3]复制的备份路径，记录元数据压缩包名，例如，"备份任务名_数据源_任务执行时间.tar.gz"。                                             |
   | RemoteHDFS | 源端NameService名称  | 备份数据集群的NameService名称。可在备集群HDFS服务的"管理NameService"页面获取，例如"hacluster"。                                                                                                                        |
   | RemoteHDFS | IP 模式            | 目标IP的IP地址模式。系统会根据集群网络类型自动选择对应的IP模式，如IPv4或者IPv6。                                                                                                                                            |
   | RemoteHDFS | 源端主NameNode IP地址 | 备集群主NameNode业务平面IP地址。登录备集群的Manager界面，选择"集群 \> 服务 \> HDFS \> 实例"，即可查看主NameNode业务平面IP地址。 仅MRS 3.2.0及之后版本需要配置该参数。              |
   | RemoteHDFS | 源端备NameNode IP地址 | 备集群备NameNode业务平面IP地址。登录备集群的Manager界面，选择"集群 \> 服务 \> HDFS \> 实例"，即可查看备NameNode业务平面IP地址。 仅MRS 3.2.0及之后版本需要配置该参数。                |
   | RemoteHDFS | 源端NameNode IP地址  | 备集群NameNode业务平面IP地址，支持主节点或备节点。登录备集群的Manager界面，选择"集群 \> 服务 \> HDFS \> 实例"，即可查看NameNode业务平面IP地址。 仅MRS 3.1.0和MRS 3.1.2版本需要配置该参数。 |
   | RemoteHDFS | 源端NameNode RPC端口 | 目的端集群HDFS基础配置"dfs.namenode.rpc.port"参数值。 仅MRS 3.2.0及之后版本需要配置该参数。                                                             |
   | RemoteHDFS | 源端路径             | 参考[步骤 3]中获取的"备份路径"，填写备集群保存备份数据的完整HDFS路径。例如，"*备份路径/备份任务名_数据源_任务创建时间/*"。                                                      |
   | OBS        | 源端路径             | 备份文件在OBS中保存的完整路径。例如："*备份路径* */* *备份任务名_* *数据源_* *任务创建时间/* *版本号_* *数据源_* *任务执行时间.tar.gz*"。                                                                                                  |
      
   
   
10. 单击"确定"保存。
11. 在恢复任务列表已创建任务的"操作"列，单击"执行"，在弹出窗口上继续单击"确定"，开始执行恢复任务。 
    - 恢复成功后进度显示为绿色。
    
    - 恢复成功后此恢复任务不支持再次执行。
    
    - 如果恢复任务在第一次执行时由于某些原因未执行成功，在排除错误原因后单击"重试"，重试恢复任务。
    
    
    
    
12. 在"集群 \> 服务"页面，启动ClickHouse服务。