
# 设置多版本备份数据保留周期（废弃，不推荐使用）
#### 功能描述
多版本功能计划废弃，不推荐使用。更多相关功能推荐：[Hudi多版本清理操作](https://support.huaweicloud.com/sqlref-hudi-dli/dli_hudi_0072.html)、[Hudi Archive操作说明](https://support.huaweicloud.com/sqlref-hudi-dli/dli_hudi_0073.html)。更
在DLI数据多版本功能开启后，备份数据默认保留7天，您可以通过配置系统参数"dli.multi.version.retention.days"调整保留周期。保留周期外的多版本数据后续在执行insert overwrite或者truncate语句时会自动进行清理。在添加列或者修改分区表时，也可以设置表属性"dli.multi.version.retention.days"调整保留周期。
开启和关闭多版本功能SQL语法请参考[开启或关闭数据多版本（废弃，不推荐使用）](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0354.html#dli_08_0354)。
DLI数据多版本功能当前仅支持通过Hive语法创建的OBS表，具体建表SQL语法可以参考[使用Hive语法创建OBS表](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0077.html#dli_08_0077)。
#### 语法格式
```
ALTER TABLE [db_name.]table_name 
SET TBLPROPERTIES ("dli.multi.version.retention.days"="days");
```
#### 关键字
- TBLPROPERTIES：TBLPROPERTIES子句给表添加key/value的属性。
 
#### 参数说明
表1参数说明 
| **参数**     | **描述**                                     |
|:---|:---|
| db_name    | 数据库名称，由字母、数字和下划线（_）组成。不能是纯数字，且不能以数字和下划线开头。 |
| table_name | 表名称。                                       |
| days       | 多版本中备份数据保留的日期。默认为7天，建议设置在1到7天范围内。          |
   
#### 注意事项
DLI数据多版本功能当前仅支持通过Hive语法创建的OBS表，具体建表语法可以参考[使用Hive语法创建OBS表](https://support.huaweicloud.com/sqlref-spark-dli/dli_08_0077.html#dli_08_0077)。
#### 示例
在DLI数据多版本中，设置备份数据保留时间为5天。
```
ALTER TABLE test_table 
SET TBLPROPERTIES ("dli.multi.version.retention.days"="5");
```
