文档首页/ MapReduce服务 MRS/ 组件操作指南（LTS版）/ 使用Hudi/ Hudi SQL语法参考/ Hudi TTL语法说明/ 开启/关闭TTL
更新时间：2026-07-06 GMT+08:00
查看PDF
分享

开启/关闭TTL

命令功能

开启或者关闭Hudi表的TTL能力。

命令格式

call ttl_configuration(table => "[table]", path => "[path]", enabled => "[enabled]", strategy => "[strategy]", value => "[value]", resolveConflictsBy => "[resolveConflictsBy]", runInline => "[runInline]")

参数描述

参数

描述

是否必填

table

String类型，表名或者库名.表名。

否，table和path二选一

path

String类型，表的绝对路径。

否，table和path二选一

enabled

String类型，是否开启TTL。

否，false或者true，默认是false

strategy

String类型，TTL的触发模式。

strategy为NUM_COMMITS时，value指定的值代表每[value]个commit/deltacommit会触发一次TTL。

strategy为TIME_ELAPSED时，value指定的值代表每[value]天会触发一次TTL。

否，NUM_COMMITS或者TIME_ELAPSED，默认是NUM_COMMITS

value

String类型，TTL的触发间隔时间。

否，默认是10

resolveConflictsBy

String类型，TTL的冲突解决策略。

  • resolveConflictsBy属性用来处理TTL策略冲突，比如dt=2023/05/01分区同时命中以下两条TTL策略：
    • 策略A：call ttl_policy_save(table => 'hudi_table', spec => 'dt=2023/05/*', units => 'DAYS', value => '2', level => 'PARTITION');
    • 策略B：call ttl_policy_save(table => 'hudi_table', spec => 'dt=2023/05/01', units => 'DAYS', value => '1', level => 'PARTITION');
  • 当resolveConflictsBy为MAX_TTL时，如果同一个分区命中多条TTL策略，则保留时间最长的策略优先级最高，对于dt=2023/05/01分区来说策略A会生效，策略B不生效。
  • 当resolveConflictsBy为MIN_TTL时，如果同一个分区命中多条TTL策略，则保留时间最短的策略优先级最高，对于dt=2023/05/01分区来说策略B会生效，策略A不生效。

否，MAX_TTL或者MIN_TTL，默认是MAX_TTL

runInline

String类型，TTL是否在写操作完成时触发。

  • true：TTL会在每次写入完成后会根据strategy和value属性的值去判断是否要检查所有分区的TTL情况，如果需要检查并且检查出老化的分区，则逻辑删除老化的分区，逻辑删除操作会生成一个replacecommit，等执行clean操作时会自动物理删除老化的分区。如果不需要检查，则跳过，进行下一次写入。
  • false：不需要指定strategy和value属性，TTL会在每次clean操作过程中去判断所有分区是否满足老化的条件，如果满足则直接物理删除老化的分区。

否，true或者false，默认是false

示例

  • 指定表名开启TTL（每10个replacecommit触发一次TTL）： 
    call ttl_configuration(table => "hudi_table", enabled => "true", strategy => "NUM_COMMITS", value => "10", resolveConflictsBy => "MAX_TTL", runInline => "true")
  • 指定路径开启TTL（每1天触发一次TTL）： 
    call ttl_configuration(path => "hdfs://hacluster/user/hive/warehouse/hudi_table/", enabled => "true", strategy => "TIME_ELAPSED", value => "1", resolveConflictsBy => "MIN_TTL", runInline => "true")
  • 指定表名开启TTL（每次clean触发TTL）： 
    call ttl_configuration(table => "hudi_table", enabled => "true", resolveConflictsBy => "MAX_TTL", runInline => "false")
  • 关闭TTL： 
    call ttl_configuration(table => "hudi_table", enabled => "false")
父主题： Hudi TTL语法说明

相关文档