更新时间:2024-12-25 GMT+08:00
分享

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权限
表2 RESTORE所需权限列表

权限描述

表的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日志和客户端中查看命令运行成功或失败。

相关文档