> 0.90 里给 mapping 加一个 `_ttl`，文档到期就会被自动删掉——不用定时任务、不用 delete-by-query。这个功能 2.0 被标记废弃，5.0 正式移除。这篇看它当年的实现细节，以及官方给的替代方案。

## **说明**

本文描述问题及解决方法同样适用于 [腾讯云 Elasticsearch Service（ES）](https://cloud.tencent.com/document/product/845)。

## 先看 0.90 的原文

0.90 的文档（[docs/reference/mapping/fields/ttl-field.asciidoc @ v0.90.13](https://github.com/elastic/elasticsearch/blob/v0.90.13/docs/reference/mapping/fields/ttl-field.asciidoc)，锚点 `mapping-ttl-field`）开篇是这么写的：

> A lot of documents naturally come with an expiration date. Documents can therefore have a `_ttl` (time to live), which will cause the expired documents to be deleted automatically.

"自动删除"这四个字在 2013 年很有吸引力——那时候没有 ILM，管理"日志只留 7 天"这类需求，要么自己写定时任务删，要么按天建索引再整体删索引。ES 内置一个 TTL，等于把这件事收进引擎里。

## 当时的用法

默认关闭，要在 mapping 里开：

```json
{
    "tweet" : {
        "_ttl" : { "enabled" : true }
    }
}
```

想给整个 type 一个默认值：

```json
{
    "tweet" : {
        "_ttl" : { "enabled" : true, "default" : "1d" }
    }
}
```

几个当时需要知道的细节，文档里都写了：

* **时间单位**：可以写 `d`（天）、`m`（分钟）、`h`（小时）、`ms`（毫秒）、`w`（周）；**不写单位默认是毫秒**——这个坑不小，`"default": "7"` 是 7 毫秒。
* **不给 `default` 也不在文档里带 `_ttl`**：文档的 TTL 是无限，永不过期。
* **存储方式**：默认 `store: yes`、`index: not_analyzed`，而且文档特意强调 `index` 必须是 `not_analyzed`，否则清理流程不工作。
* **改默认值**：可以用 put mapping 动态更新 `default`，但**只影响之后写入的文档**，已索引的文档 TTL 不变。

## 过期是怎么执行的

文档里有一节 "Note on documents expiration"，把实现说得很直白：

> Expired documents will be automatically deleted regularly. You can dynamically set the `indices.ttl.interval` to fit your needs. The default value is `60s`.

也就是说：**后台有一个周期性任务，默认每 60 秒跑一次**，扫出过期的文档删掉。相关参数：

| 设置 | 默认 | 作用 |
|---|---|---|
| `indices.ttl.interval` | `60s` | 清理任务的运行间隔 |
| `indices.ttl.bulk_size` | `10000` | 每批删除的文档数 |

还有一条设计得挺细的说明：

> Note that the expiration procedure handle versioning properly so if a document is updated between the collection of documents to expire and the delete order, the document won't be deleted.

即"扫描出待删列表"到"真正发删除"之间，如果文档被更新过，就不会被删。避免刚写入的新数据被误删。

## 它为什么被拿掉

**2.0 先标记废弃**（[migrate_2_0/mapping.asciidoc @ v2.4.6](https://github.com/elastic/elasticsearch/blob/v2.4.6/docs/reference/migration/migrate_2_0/mapping.asciidoc)）：

```
260: ==== `_timestamp` and `_ttl` deprecated
262: The `_timestamp` and `_ttl` fields are deprecated, but will remain functional
268: The current `_ttl` functionality will be replaced in a future version with a
```

关键词是 "remain functional"——2.0 只是宣布，功能照旧能用。

**5.0 正式移除**（[migrate_5_0/mapping.asciidoc @ v5.6.16](https://github.com/elastic/elasticsearch/blob/v5.6.16/docs/reference/migration/migrate_5_0/mapping.asciidoc)）：

> The `_timestamp` and `_ttl` fields were deprecated and are now removed. As a replacement for `_timestamp`, you should populate a regular date field with the current timestamp on application side. For `_ttl`, you should either use time-based indices, or delete documents with a delete-by-query on a timestamp field.

官方给的替代方案两条，也正是现在还在用的做法：

* **`_timestamp`**：别指望引擎给你记时间，应用层自己写一个普通 date 字段；
* **`_ttl`**：要么**按时间建索引**（到期整个索引删掉），要么**按时间字段跑 delete-by-query**。

至于为什么：文档没直说。我能核实到的机制问题是——`_ttl` 的清理靠周期性扫描 + 批量删除，文档过期这件事被塞进了引擎的后台任务里，规模一大就是持续的额外负担；而"按时间建索引"把删除变成整个索引的丢弃，代价低得多。这段是我的判断，不是官方说法。

## 它不是孤例：0.90 的元字段家族

`_ttl` 不是单独存在的。0.90 的 `docs/reference/mapping/fields/` 目录下并排放着这些元字段页面：

`_all`、`_analyzer`、`_boost`、`_id`、`_index`、`_parent`、`_routing`、`_size`、`_source`、`_timestamp`、`_ttl`、`_type`、`_uid`。

可以看到那个年代的思路：ES 倾向于把"文档生命周期里常见的需求"直接做成元字段——时间有 `_timestamp`、过期有 `_ttl`、父子关系有 `_parent`、路由有 `_routing`、权重有 `_boost`。

这些元字段后来的命运高度一致：`_boost` 在 1.0 被移除（改用 `function_score`），`_timestamp` 和 `_ttl` 在 2.0 废弃、5.0 移除，`_all` 在 6.0 默认关闭、7.0 彻底移除，`_parent` 最终被 `join` 字段接替。活到今天的只有 `_source`、`_id`、`_routing` 等少数几个。

这条脉络比单个字段的存废更值得记：ES 从"什么都内置"走向"引擎只做引擎"的过程，就是靠一次次迁移文档里的 deprecated / removed 完成的。

## 如果你还在维护带 `_ttl` 的老集群

升级路径上有一条硬阻断，5.0 的迁移文档写得很直接（`migrate_5_0/mapping.asciidoc#L183`）：

> `_ttl` and `_timestamp` cannot be created

意思是 5.0 之后带这两个元字段的 mapping **直接创建失败**，不是告警、不是忽略，是报错。所以：

* 升到 5.x 之前，必须先把 mapping 里的 `_ttl`、`_timestamp` 清掉；
* 清掉之后，原本靠 `_ttl` 自动删除的数据要用别的手段接住——按官方给的替代方案，就是把"按时间建索引 + 到期删索引"这条链路先搭好再切；
* 切换期间注意数据量的台阶：从逐文档删除变成整索引删除，磁盘占用的曲线形状会不一样，别按老经验设告警。

## 现在的做法对照

| 需求 | 0.90 的做法 | 现在的做法 |
|---|---|---|
| 文档自动过期 | mapping 里 `_ttl.enabled` + `default` | 按时间建索引（rollup/数据流 + ILM），到期删整个索引 |
| 保留时间戳 | `_timestamp` 元字段 | 应用层写普通 date 字段 |
| 按条件清理 | 引擎后台扫描 | delete-by-query / ILM 的删除阶段 |

## 写在最后

* **`_ttl` 的兴衰是 ES 设计取向变化的一个标本**：0.90 什么都想内置（TTL、timestamp、boost 字段、facets 都是），2.0 开始往"引擎只做引擎"的方向收，5.0 把这些内置功能一次性清理掉。
* **现在不要再找替代品去实现"单文档 TTL"**——官方明确指向按时间分索引这条路，顺着做，成本最低。
* **老集群升级时注意**：5.0 起带 `_ttl` 的 mapping 直接创建失败（`migrate_5_0/mapping.asciidoc#L183` 那条 `_ttl` and `_timestamp` cannot be created），不是警告，是报错。

## 参考

- [mapping/fields/ttl-field.asciidoc @ v0.90.13](https://github.com/elastic/elasticsearch/blob/v0.90.13/docs/reference/mapping/fields/ttl-field.asciidoc)
- [migrate_2_0/mapping.asciidoc#L260-L268 @ v2.4.6](https://github.com/elastic/elasticsearch/blob/v2.4.6/docs/reference/migration/migrate_2_0/mapping.asciidoc)
- [migrate_5_0/mapping.asciidoc#L88-L94、L183 @ v5.6.16](https://github.com/elastic/elasticsearch/blob/v5.6.16/docs/reference/migration/migrate_5_0/mapping.asciidoc)

> 本文引用的原文均取自本地 `elasticsearch/` 仓库的 `v0.90.13` / `v2.4.6` / `v5.6.16` 标签。0.90 那份文档没有可用的行号锚点，按章节标题引用；2.0/5.0 的引用带行号。"为什么被拿掉"一节中官方未说明原因的部分已标明是我的判断。


0.90 里给 mapping 加一个 _ttl，文档到期就会被自动删掉——不用定时任务、不用 delete-by-query。这个功能 2.0 被标记废弃，5.0 正式移除。这篇看它当年的实现细节，以及官方给的替代方案。

ES 曾经自带"文档自动过期"：0.90 的 `_ttl` 是怎么干活、又是怎么没的

0.90 里给 mapping 加一个 ttl，文档到期就会被自动删掉——不用定时任务、不用 delete-by-query。

官方产研

云计算

后端

大数据

Elasticsearch 0.90版_ttl元字段可自动删除过期文档，默认60秒扫描，支持时间单位设置，2.0废弃5.0移除。官方推荐按时间建索引或delete-by-query替代。升级需先清除_ttl配置，否则创建失败，腾讯云ES同样适用。

Elasticsearch 

代码解释

数据流

路由

2026上云采购 | AI焕新·智启新局

bigdata-class

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

ES 曾经自带"文档自动过期"：0.90 的 `_ttl` 是怎么干活、又是怎么没的-腾讯云开发者社区-腾讯云

ES 曾经自带"文档自动过期"：0.90 的 `_ttl` 是怎么干活、又是怎么没的

ES 曾经自带"文档自动过期"：0.90 的 `_ttl` 是怎么干活、又是怎么没的

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐