Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

ALTER TABLE ... MODIFY TTL

View as MarkdownEdit this pageReport an issueSet up docs MCP

MODIFIER LE TTL

Vous pouvez modifier le TTL de la table à l’aide d’une requête de la forme suivante :

ALTER TABLE [db.]table_name [ON CLUSTER cluster] MODIFY TTL ttl_expression;

SUPPRIMER LE TTL

Vous pouvez supprimer la propriété TTL de la table à l’aide de la requête suivante :

ALTER TABLE [db.]table_name [ON CLUSTER cluster] REMOVE TTL

Exemple

Considérez la table avec le TTL défini au niveau de la table :

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');

Exécutez OPTIMIZE pour forcer le nettoyage du TTL :

OPTIMIZE TABLE table_with_ttl FINAL;
SELECT * FROM table_with_ttl FORMAT PrettyCompact;

La deuxième ligne a été supprimée de la table.

┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
└───────────────────────┴─────────┴──────────────┘

Supprimez maintenant le TTL de la table avec la requête suivante :

ALTER TABLE table_with_ttl REMOVE TTL;

Réinsérez la ligne supprimée et relancez de force le nettoyage TTL avec OPTIMIZE :

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;

Le TTL n’est plus défini, donc la deuxième ligne n’est pas supprimée :

┌─────────event_time────┬──UserID─┬─────Comment──┐
│   2020-12-11 12:44:57 │       1 │    username1 │
│   2020-08-11 12:44:57 │       2 │    username2 │
└───────────────────────┴─────────┴──────────────┘

Voir aussi

Navigation