
# 恢复多版本备份数据（废弃，不推荐使用）
#### 功能描述
多版本功能计划废弃，不推荐使用。更多相关功能推荐：[Hudi多版本清理操作](https://support.huaweicloud.com/sqlref-hudi-dli/dli_hudi_0072.html)、[Hudi Archive操作说明](https://support.huaweicloud.com/sqlref-hudi-dli/dli_hudi_0073.html)。更
在DLI数据多版本功能开启后，您可以通过RESTORE TABLE命令恢复表或分区数据到指定版本。开启和关闭多版本语法请参考[开启或关闭数据多版本（废弃，不推荐使用）](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0354.html#dli_08_0354)。
DLI数据多版本功能当前仅支持通过Hive语法创建的OBS表，具体建表SQL语法可以参考[使用Hive语法创建OBS表](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0077.html#dli_08_0077)。
#### 语法格式
- 恢复非分区表数据到指定版本的备份数据
  ```
  RESTORE TABLE [db_name.]table_name TO VERSION 'version_id';
  ```
  
- 恢复分区表的单个分区数据为指定版本的备份数据
  ```
  RESTORE TABLE [db_name.]table_name PARTITION (column = value, ...) TO VERSION 'version_id';
  ```
  
 
#### 关键字
- RESTORE TABLE：恢复备份数据。
- PARTITION：指定分区列。
- TO VERSION：指定版本号。具体的版本号可以通过**SHOW HISTORY** 命令获取，详情请参考[查看多版本备份数据（废弃，不推荐使用）](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0351.html#dli_08_0351)。
 
#### 参数说明
表1参数说明 
| **参数**     | **描述**                                                                                                                                                 |
|:---|:---|
| db_name    | 数据库名称，由字母、数字和下划线（_）组成。不能是纯数字，且不能以数字和下划线开头。                                                                                                             |
| table_name | 表名称。                                                                                                                                                   |
| column     | 分区列名。                                                                                                                                                  |
| value      | 分区列名对应的值。                                                                                                                                              |
| version_id | 指定版本号恢复备份数据。具体的版本号可以通过**SHOW HISTORY** 命令获取，详情请参考[查看多版本备份数据（废弃，不推荐使用）](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0351.html#dli_08_0351)。 |
   
#### 注意事项
DLI数据多版本功能当前仅支持通过Hive语法创建的OBS表，具体建表SQL语法可以参考[使用Hive语法创建OBS表](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0077.html#dli_08_0077)。
#### 示例
- 在DLI数据多版本中，恢复非分区表test_table数据到版本20210930。
  ```
  RESTORE TABLE test_table TO VERSION '20210930';
  ```
  

- 在DLI数据多版本中，恢复分区表test_table对应dt分区数据到版本20210930。
  ```
  RESTORE TABLE test_table PARTITION (dt='2021-07-27') TO VERSION '20210930';
  ```
  
 
