> ## 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)によるデータ管理](/ja/concepts/features/operations/delete/ttl)をご覧ください。以下では、既存の 有効期限 (TTL) ルールを変更または削除する方法を説明します。
</Note>

<div id="modify-ttl">
  ## 有効期限 (TTL) を変更
</div>

次の形式のリクエストで、[テーブルの有効期限 (TTL)](/ja/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');
```

`有効期限 (TTL)` のクリーンアップを強制するには、`OPTIMIZE` を実行します。

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

テーブルの2行目が削除されました。

```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` がなくなったため、2 行目は削除されません。

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

**関連項目**

* [有効期限 (TTL)-expression](/ja/reference/statements/create/table#ttl-expression) の詳細。
* [有効期限 (TTL) を使用したカラムの変更](/ja/reference/statements/alter/ttl)。