更新时间:2024-07-27 GMT+08:00
禁止或恢复表的生命周期
功能介绍
禁止或恢复指定表或分区的生命周期。
使用禁止或恢复表的生命周期有以下两种场景:
- 表或分区表开启了生命周期的功能,该功能可以禁止或恢复表的生命周期,即修改“dli.table.lifecycle.status”的参数值。
- 表或分区表未开启生命周期的功能,使用禁止或恢复表的生命周期,则会增加“dli.table.lifecycle.status”这一属性。
约束限制
- 表生命周期处于公测阶段,如果有需要请联系客服申请开通白名单。
- 表生命周期功能支持Hive、DataSource语法创建表、多版本表,暂不支持跨源表、Carbon表。
- 生命周期单位为天,取值为正整数。
- 生命周期只能在表级别设置,不能在分区级设置。为分区表指定的生命周期,适用于该表所有的分区。
语法格式
- 该语法在表级别禁止或恢复表的生命周期
1
ALTER TABLE table_name SET TBLPROPERTIES("dli.table.lifecycle.status"={enable|disable});
- 该语法可在表或分区表级别禁止或恢复指定表
1
ALTER TABLE table_name [pt_spec] LIFECYCLE {enable|disable};
关键字
TBLPROPERTIES:表的属性,增加表的生命周期功能。
参数说明
参数名称 |
是否必选 |
参数说明 |
---|---|---|
table_name |
是 |
待禁止或恢复生命周期的表的名称。 |
pt_spec |
否 |
待禁止或恢复生命周期的表的分区信息。格式为partition_col1=col1_value1, partition_col2=col2_value1...。对于有多级分区的表,必须指明全部的分区值。 |
enable |
否 |
恢复表或指定分区的生命周期功能
|
disable |
否 |
禁止表或指定分区的生命周期功能。
|
示例
- 示例1:禁止表test_lifecycle的生命周期功能。
1
alter table test_lifecycle SET TBLPROPERTIES("dli.table.lifecycle.status"='disable');
- 示例2:禁止表test_lifecycle中时间为20230520分区的生命周期功能。
1
alter table test_lifecycle partition (dt='20230520') LIFECYCLE 'disable';
- 当设置禁止分区表的生命周期功能后,该表的所有分区的生命周期功能都会被禁止。
父主题: 表生命周期管理