大网数据广告活动
数据库部署与 SQL 参考

使用 TTL (Time to Live) 定期删除过期数据

· 52CE 我爱测

在应用开发中,一些数据通常只在特定时间内具有价值。例如,验证码通常只需保留几分钟,短链接可能仅在活动期间有效,而访问日志或中间计算结果往往只需保存几个月。

使用 TTL (Time to Live) 定期删除过期数据

在应用开发中,一些数据通常只在特定时间内具有价值。例如,验证码通常只需保留几分钟,短链接可能仅在活动期间有效,而访问日志或中间计算结果往往只需保存几个月。

TiDB 的 TTL (Time to Live) 功能提供了一种行级别的生命周期控制策略,能帮助你自动、定期地删除这些过期数据,而无需编写复杂的定时任务脚本。

适用场景

TTL 旨在解决“过期后不再具有业务价值”的数据清理问题,适合以下场景:

  • 定期删除验证码、短网址记录
  • 定期删除不需要的历史订单
  • 自动删除计算的中间结果

注意:

TTL 任务在后台周期执行,因此不保证数据在过期后立即被删除。

快速上手

你可以在建表时直接配置 TTL 属性,也可以对现有表进行修改。以下章节列出了使用 TTL 定期删除过期数据的基本示例。完整的示例和 TTL 使用限制,以及 TTL 与其他工具或功能的兼容性请参考 TTL (Time to Live)。

创建带 TTL 的表

如需创建一个存储即时消息的表 app_messages,并且希望消息在创建 3 个月后自动删除,可以执行以下语句:

CREATE TABLE app_messages (
    id BIGINT NOT NULL AUTO_INCREMENT PRIMARY KEY,
    sender_id INT,
    msg_content TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) TTL = `created_at` + INTERVAL 3 MONTH;

其中,TTL = ... 用于定义过期策略,created_at 表示数据的创建时间,INTERVAL 3 MONTH 设置了表中行的最长存活时间为 3 个月。

为现有表增加 TTL

当你已经有一张表 app_logs,如需为该表新增自动清理功能(例如只保留 1 个月的数据),可以执行以下语句:

ALTER TABLE app_logs TTL = `created_at` + INTERVAL 1 MONTH;

调整 TTL 时长

如需调整表 app_logs 的 TTL 时长,可以执行以下语句:

ALTER TABLE app_logs TTL = `created_at` + INTERVAL 6 MONTH;

关闭 TTL 功能

如需关闭表 app_logs 的 TTL 功能,可以执行以下语句:

ALTER TABLE app_logs TTL_ENABLE = 'OFF';

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。