ClickHouse列和表的TTL生命周期

ClickHouse列和表的TTL

列和表的 TTL
TTL 可以设置值的生命周期，它既可以为整张表设置，也可以为每个列字段单独设置。表级别的 TTL 还会指定数据在磁盘和卷上自动转移的逻辑。

TTL 表达式的计算结果必须是 日期 或 日期时间 类型的字段。

示例：

TTL time_column
TTL time_column + interval

要定义interval, 需要使用 时间间隔 操作符。

TTL date_time + INTERVAL 1 MONTH
TTL date_time + INTERVAL 15 HOUR

• 列 TTL

当列中的值过期时, ClickHouse会将它们替换成该列数据类型的默认值。如果数据片段中列的所有值均已过期，则ClickHouse 会从文件系统中的数据片段中此列。

TTL子句不能被用于主键字段。

示例:

创建表时指定 TTL

CREATE TABLE example_table
(
    d DateTime,
    a Int TTL d + INTERVAL 1 MONTH,
    b Int TTL d + INTERVAL 1 MONTH,
    c String
)
ENGINE = MergeTree
PARTITION BY toYYYYMM(d)
ORDER BY d;

为表中已存在的列字段添加 TTL

ALTER TABLE example_table
    MODIFY COLUMN
    c String TTL d + INTERVAL 1 DAY;

• 1
• 2
• 3

修改列字段的 TTL

ALTER TABLE example_table
    MODIFY COLUMN
    c String TTL d + INTERVAL 1 MONTH;

• 1
• 2
• 3

表 TTL
表可以设置一个用于移除过期行的表达式，以及多个用于在磁盘或卷上自动转移数据片段的表达式。当表中的行过期时，ClickHouse 会删除所有对应的行。对于数据片段的转移特性，必须所有的行都满足转移条件。

TTL expr [DELETE|TO DISK 'aaa'|TO VOLUME 'bbb'], ...

• 1

TTL 规则的类型紧跟在每个 TTL 表达式后面，它会影响满足表达式时（到达指定时间时）应当执行的操作：

DELETE - 删除过期的行（默认操作）;
TO DISK ‘aaa’ - 将数据片段移动到磁盘 aaa;
TO VOLUME ‘bbb’ - 将数据片段移动到卷 bbb.
示例:

创建时指定 TTL

CREATE TABLE example_table
(
    d DateTime,
    a Int
)
ENGINE = MergeTree
PARTITION BY toYYYYMM(d)
ORDER BY d
TTL d + INTERVAL 1 MONTH [DELETE],
    d + INTERVAL 1 WEEK TO VOLUME 'aaa',
    d + INTERVAL 2 WEEK TO DISK 'bbb';

修改表的 TTL

ALTER TABLE example_table
    MODIFY TTL d + INTERVAL 1 DAY;

修改ClickHouse表TTL

ALTER TABLE aplus.`dwd_aplus_log_event_ri_local` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`dwd_aplus_log_event_ri_local_partition_delete` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`ads_aplus_cohort_info_adhoc_local` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`ads_aplus_cohort_info_adhoc_local_partition_delete` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`ads_aplus_cohort_info_daily_local` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`ads_aplus_cohort_info_daily_local_partition_delete` on cluster default MODIFY TTL stat_date + toIntervalDay(9999);

ALTER TABLE aplus.`dwd_aplus_log_session_di_local` on cluster default MODIFY TTL toDate(parseDateTimeBestEffort(ds)) + toIntervalDay(9999);

ALTER TABLE aplus.`dwd_aplus_log_session_di_local_partition_delete` on cluster default MODIFY TTL toDate(parseDateTimeBestEffort(ds)) + toIntervalDay(9999);

ALTER TABLE aplus.`ads_aplus_cohort_info_local` on cluster default MODIFY TTL toDate(parseDateTimeBestEffort(ds)) + toIntervalDay(9999);