> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 表生存时间 (TTL) 修改操作文档

# 表生存时间 (TTL) 的修改操作

<Note>
  如果你想了解如何使用 生存时间 (TTL) 管理旧数据的详细信息，请参阅[使用 生存时间 (TTL) 管理数据](/zh/concepts/features/operations/delete/ttl)用户指南。以下文档说明了如何修改或移除现有的 生存时间 (TTL) 规则。
</Note>

<div id="modify-ttl">
  ## 修改生存时间 (TTL)
</div>

你可以通过如下形式的请求修改[表生存时间 (TTL)](/zh/reference/engines/table-engines/mergetree-family/mergetree#mergetree-table-ttl)：

```sql theme={null}
ALTER TABLE [db.]table_name [ON CLUSTER cluster] MODIFY TTL ttl_expression;
```

<div id="remove-ttl">
  ## 移除生存时间 (TTL)
</div>

可使用以下查询移除表的生存时间 (TTL) 属性：

```sql theme={null}
ALTER TABLE [db.]table_name [ON CLUSTER cluster] REMOVE TTL
```

**示例**

假设有如下设置了表 `TTL` 的表：

```sql theme={null}
CREATE TABLE table_with_ttl
(
    event_time DateTime,
    UserID UInt64,
    Comment String
)
ENGINE MergeTree()
ORDER BY tuple()
TTL event_time + INTERVAL 3 MONTH
SETTINGS min_bytes_for_wide_part = 0;

INSERT INTO table_with_ttl VALUES (now(), 1, 'username1');

INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
```

运行 `OPTIMIZE` 以强制触发 `TTL` 清理：

```sql theme={null}
OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;
```

表中的第二行已被删除。

```text theme={null}
┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
└───────────────────────┴─────────┴──────────────┘
```

现在使用以下查询删除表的 `TTL`：

```sql theme={null}
ALTER TABLE table_with_ttl REMOVE TTL;
```

重新插入已删除的行，并使用 `OPTIMIZE` 再次强制触发 `TTL` 清理：

```sql theme={null}
INSERT INTO table_with_ttl VALUES (now() - INTERVAL 4 MONTH, 2, 'username2');
OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;
```

`TTL` 已被移除，因此第二行不会被删除：

```text theme={null}
┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
│   2020-08-11 12:44:57 │       2 │    username2 │
└───────────────────────┴─────────┴──────────────┘
```

**另请参阅**

* 更多信息请参见 [生存时间 (TTL) 表达式](/zh/reference/statements/create/table#ttl-expression)。
* [使用 生存时间 (TTL)](/zh/reference/statements/alter/ttl) 修改列。