Hologres自V4.0版本开始支持Time Travel功能,开启该功能后,可记录数据每次变更(INSERT、DELETE、UPDATE、INSERT OVERWRITE等)的历史版本,支持在指定时间范围内查询任意时间点历史数据(即已更新或删除的数据)。通过Time Travel功能您可以分析指定时间段内数据的使用情况、恢复误删除或更新前的数据,避免业务损失。
使用限制
-
仅Hologres V4.0及以上版本支持该功能。如果您的实例是Hologres V4.0以下版本请参见实例升级。
-
仅Hologres内部表、Dynamic Table支持使用Time Travel。
说明外部表的Time Travel查询见基于DLF Catalog访问Paimon数据。
使用说明
设置Time Travel
-
语法:
Time Travel是表级别的属性,需要在建表时设置如下两个属性:
CREATE TABLE <table_name> (...) WITH ( enable_mvcc = 'true|false', mvcc_gc_ttl_seconds = '<num>' ); -
使用说明
-
已有表不支持设置上述参数,必须新建表时设置。
-
开启Time Travel后,表会保存多个版本的数据,会有额外的存储增加。
-
开启Time Travel后,查询时可能会有一定的性能损失。
-
-
参数说明
参数名称
描述
enable_mvcc
是否开启Time Travel功能,取值如下:
-
true:开启,Time Travel开启后,不支持关闭。
-
false(默认值):关闭。
mvcc_gc_ttl_seconds
开启Time Travel后,每个数据版本保留的时长,单位为秒(s)。
-
默认值为1天=24*3600 s=86400 s。
-
最小值为0:不表示关闭Time Travel,而是表示在0 s后会回收版本的数据,无法查询。
说明查询超过Time Travel保留的TTL时间范围时,系统会在后台不定期删除保留的版本数据,查询时会报错,示例报错
Tablexxx only supports time traveling between xxx and xxx;。 -
通过Time Travel查询数据
开启Time Travel后,在TTL范围内,可以使用FOR TIMESTAMP AS OF语法查询某个时间点的数据,语法如下:
SELECT * FROM <table_name> FOR TIMESTAMP AS OF (now() - INTERVAL '1 hour');
SELECT * FROM <table_name> FOR TIMESTAMP AS OF '2025-08-05 11:18:50+08';
SELECT * FROM <table_name> FOR TIMESTAMP AS OF 1754374966;
修改Time Travel的TTL
可以根据业务情况修改Time Travel的TTL,语法如下:
ALTER TABLE <table_name> SET (mvcc_gc_ttl_seconds = <num>);
修改TTL的行为说明如下:
-
当TTL从大的值变更为小的值时:系统会在后台根据新TTL值删除过期的版本数据,超过TTL的版本数据查询会报错。
-
当TTL从小的值变更为大的值时:会导致之前已经删除了在TTL范围内的版本记录,已经删除的无法恢复,会导致查询不准确。因此,不建议生产中将TTL从小值变更为大的值。
使用示例
-
创建表并开启Time Travel。
BEGIN; CREATE TABLE test1 ( a INT NOT NULL PRIMARY KEY, b INT, c INT ) WITH ( enable_mvcc = TRUE, mvcc_gc_ttl_seconds = 864000 ); COMMIT; --插入数据 INSERT INTO test1 VALUES (1, 2, 3); -
通过Time Travel查询数据。
SELECT * FROM test1 FOR TIMESTAMP AS OF now();返回结果如下。
a b c ------ 1 2 3 -
更新表并通过Time Travel查询。
INSERT INTO test1 (a, b, c) VALUES (1, 4, 5) ON CONFLICT (a) DO UPDATE SET b = EXCLUDED.b; SELECT * FROM test1 FOR TIMESTAMP AS OF (now() - INTERVAL '1 minute');返回结果如下。
a b c ------ 1 4 5