Modification du TTL de la table

Documentation sur la modification du TTL de la table

Si vous cherchez des détails sur l’utilisation de TTL pour gérer les données anciennes, consultez le guide utilisateur Gérer les données avec TTL. La documentation ci-dessous explique comment modifier ou supprimer une règle de TTL existante.

​

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

• En savoir plus sur l’expression TTL.
• Modifier une colonne avec TTL.