更新时间:2023-10-25 GMT+08:00

修改表生命周期的时间

功能描述

修改已存在的分区表或非分区表的生命周期。

当第一次开启生命周期时,会扫描表/分区会扫描路径下的表数据文件,更新表/分区的LAST_ACCESS_TIME,耗时与分区数和文件数相关。

约束限制

  • 表生命周期处于公测阶段,如果有需要请联系客服申请开通白名单。
  • 表生命周期功能支持Hive、DataSource语法创建表、多版本表,暂不支持跨源表、Carbon表。
  • 生命周期单位为天,取值为正整数。
  • 生命周期只能在表级别设置,不能在分区级设置。为分区表指定的生命周期,适用于该表所有的分区。

语法格式

ALTER TABLE table_name
SET TBLPROPERTIES("dli.lifecycle.days"='N')

关键字

TBLPROPERTIES:表的属性增加表的生命周期功能。

参数说明

表1 修改表的生命周期参数说明

参数名称

是否必选

参数说明

table_name

需要修改生命周期的表名。

dli.lifecycle.days

修改后的生命周期时间,只能为正整数,单位为天。

示例

  • 示例1:修改表的生命周期,开启test_lifecycle_exists表生命周期,并将生命周期设为50天。
    alter table test_lifecycle_exists
    SET TBLPROPERTIES("dli.lifecycle.days"='50');
  • 示例2:对已存在且未设置生命周期的分区表或非分区表开启表的生命周期,开启test_lifecycle_exists表生命周期,并将生命周期设为50天。
    alter table test_lifecycle_exists
    SET TBLPROPERTIES(
        "dli.lifecycle.days"='50',
        "dli.table.lifecycle.status"='enable'
    );