
# RESTORE
#### 命令功能
RESTORE命令用于将Delta表还原到早期状态，支持还原到较早的版本号或者时间戳。
#### 命令格式
还原Delta表到历史某一时刻的状态：
*RESTORE* *\[TABLE\]* *\[database_name.\]table_name\|* *DELTA.\`obs_path\`* 
*\[TO\] TIMESTAMP AS OF* *timestamp_expression*
还原Delta表到某一历史版本的状态：
*RESTORE\[TABLE\]* *\[database_name.\]table_name\|* *DELTA.\`obs_path\`* 
*\[TO\]* *VERSION AS OF version_code*
#### 参数描述
表1参数描述 
| 参数                   | 描述                                       |
|:---|:---|
| database_name        | Database名称，由字母、数字和下划线（_）组成。              |
| table_name           | Database中的表名，由字母、数字和下划线（_）组成。            |
| obs_path             | Obs路径，表示Delta表的存储位置。                     |
| timestamp_expression | 时间戳，不能晚于当前时间，格式'yyyy-MM-ddTHH:mm:ss.SSS' |
| version_code         | 1.3.1中查询结果中的版本号                          |
   
#### 所需权限
- SQL权限
表2RESTORE所需权限列表 
| 权限描述       |
|:---|
| 表的UPDATE权限 |
   
- 细粒度权限：dli:table:update。
- 由LakeFormation提供的元数据服务，权限配置详见LakeFormation文档。
 
#### 示例
```
RESTORE delta_table0 TO TIMESTAMP AS OF '2020-10-18 22:15:12.013';
RESTORE delta.`obs://bucket_name/db0/delta_table0` VERSION AS OF 2;
```
#### 系统响应
可在driver日志和客户端中查看命令运行成功或失败。
