RESTORE DYNAMIC TABLE
功能概述
历史版本恢复：
使用本命令，你可以将未删除的表或动态表恢复到指定的历史版本。借助时间旅行功能，你可以轻松地将表状态回滚到过去的某个时刻，以便在需要时恢复数据。
数据保留周期：
对象的历史恢复能力取决于数据的保留周期。当前预览版本的数据保留周期默认为7天，未来将调整为1天。你可以通过执行ALTER命令来调整保留周期。请注意，修改保留周期可能会增加存储成本。本功能支持表（TABLE）和动态表（DYNAMIC TABLE），不支持物化视图。
语法示例
RESTORE TABLE table_name TO time_travel_version;
time_travel_version ::=
TIMESTAMP AS OF timestamp_expression;
参数说明
- table_name：指定未删除的表名，可以是TABLE、DYNAMIC TABLE或MATERIALIZED VIEW。若表已被删除，请使用UNDROP命令进行恢复。
- time_travel_version：指定要恢复的表版本。先使用
DESC HISTORY table_name
DESC HISTORY table_name
查看版本时间点，再通过TIMESTAMP AS OF
TIMESTAMP AS OF
子句来指定具体的时间点。timestamp_expression
timestamp_expression
是一个返回时间戳类型表达式的参数，例如：
'2023-11-07 14:49:18'
'2023-11-07 14:49:18'
，即可强制转换为时间戳的字符串。CAST('2023-11-07 14:49:18' AS TIMESTAMP)
CAST('2023-11-07 14:49:18' AS TIMESTAMP)
。CURRENT_TIMESTAMP() - INTERVAL 12 HOURS
CURRENT_TIMESTAMP() - INTERVAL 12 HOURS
：12小时之前的版本。- 任何本身是时间戳类型或可强制转换为时间戳的表达式。
使用案例
案例 1：使用 RESTORE 命令恢复普通表到指定版本
-- 查看表的变更历史
DESC HISTORY json_table;
-- 使用 RESTORE 命令恢复到指定版本
RESTORE TABLE json_table TO TIMESTAMP AS OF '2024-01-26 17:44:45.349';
SELECT * FROM json_table;
-- 查询结果
+----------------------------------+
| j |
+----------------------------------+
| {"id":1,"value":"200"} |
| {"id":2,"value":"300"} |
| {"extra":1,"id":3,"value":"400"} |
| {"value":"100"} |
+----------------------------------+
案例 2：使用 RESTORE 命令恢复动态表到指定版本
- 需要注意的是，如果动态表依赖的表数据没有变化，下次动态表刷新又会恢复成原来的结果。
DROP TABLE IF EXISTS dy_base_a;
CREATE TABLE dy_base_a (i int, j int);
INSERT INTO dy_base_a VALUES
(1,10),
(2,20),
(3,30),
(4,40);
--使用dynamic table进行加工
DROP DYNAMIC TABLE IF EXISTS change_table;
CREATE DYNAMIC TABLE change_table
(i,j)
AS select * from dy_base_a;
--刷新dynamic table
refresh DYNAMIC TABLE change_table;
--查询表数据
SELECT *
FROM change_table;
+---+----+
| i | j |
+---+----+
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
| 4 | 40 |
+---+----+
--向基表中插入数据
INSERT INTO dy_base_a VALUES(5,10);
--刷新dynamic table
refresh DYNAMIC TABLE change_table;
--查询表数据
SELECT *
FROM change_table;
+---+----+
| i | j |
+---+----+
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
| 4 | 40 |
| 5 | 10 |
+---+----+
--恢复最初的版本
DESC HISTORY change_table;
+---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
| version | time | total_rows | total_bytes | user | operation | job_id | source_tables |
+---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
| 3 | 2024-12-27 12:04:20.738 | 5 | 4950 | UAT_TEST | REFRESH | 2024122712042034961pl5i9617jc | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"3"," |
| 2 | 2024-12-27 12:01:33.349 | 4 | 2501 | UAT_TEST | REFRESH | 2024122712013303061pl5i9617dk | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public","version":"2"," |
| 1 | 2024-12-27 12:01:33.078 | 0 | 0 | UAT_TEST | CREATE | 2024122712013279961pl5i9616do | [{"table_name":"dy_base_a","workspace":"qingyun","schema":"public"}] |
+---------+-------------------------+------------+-------------+----------+-----------+-------------------------------+------------------------------------------------------------------------------------+
--恢复至指定版本
RESTORE TABLE change_table TO TIMESTAMP AS OF '2024-12-27 12:01:33.349';
--查询数据
SELECT *
FROM change_table;
+---+----+
| i | j |
+---+----+
| 1 | 10 |
| 2 | 20 |
| 3 | 30 |
| 4 | 40 |
+---+----+
注意事项
- 请确保在执行
RESTORE
RESTORE
命令时，指定的时间点在表的保留期内。
- 执行
RESTORE
RESTORE
命令后，表的数据将被还原到指定的历史版本，但不会删除后续的历史版本。
- 请谨慎使用
RESTORE
RESTORE
命令，以避免数据丢失或不一致的风险。在执行此操作之前，建议先备份相关数据。
