Passer au contenu principal

​
Description

La table contient des informations sur les mutations des tables MergeTree ainsi que sur leur avancement. Chaque commande de mutation est représentée par une seule ligne.

​
Colonnes :

  • database (String) — Le nom de la base de données à laquelle la mutation a été appliquée.
  • table (String) — Le nom de la table à laquelle la mutation a été appliquée.
  • mutation_id (String) — L’ID de la mutation. Pour les tables répliquées, ces ID correspondent aux noms des znodes dans le répertoire <table_path_in_clickhouse_keeper>/mutations/ de ClickHouse Keeper. Pour les tables non répliquées, les ID correspondent aux noms de fichiers dans le répertoire de données de la table.
  • command (String) — La chaîne de commande de la mutation (la partie de la requête après ALTER TABLE [db.]table).
  • create_time (DateTime) — La date et l’heure auxquelles la commande de mutation a été soumise à l’exécution.
  • block_numbers.partition_id (Array(String)) — Pour les mutations de tables répliquées, le tableau contient les ID des partitions (un enregistrement pour chaque partition). Pour les mutations de tables non répliquées, le tableau est vide.
  • block_numbers.number (Array(Int64)) — Pour les mutations de tables répliquées, le tableau contient un enregistrement pour chaque partition, avec le numéro de bloc obtenu par la mutation. Seules les parts contenant des blocs dont les numéros sont inférieurs à cette valeur seront mutées dans la partition. Dans les tables non répliquées, les numéros de bloc de toutes les partitions forment une seule séquence. Cela signifie que, pour les mutations de tables non répliquées, la colonne contiendra un enregistrement avec un seul numéro de bloc obtenu par la mutation.
  • parts_in_progress_names (Array(String)) — Un tableau des noms des parties de données en cours de mutation.
  • parts_to_do_names (Array(String)) — Un tableau des noms des parties de données qui doivent être mutées pour que la mutation soit terminée.
  • parts_to_do (Int64) — Le nombre de parties de données qui doivent être mutées pour que la mutation soit terminée. Remarque : même si parts_to_do = 0, la mutation d’une table répliquée peut ne pas être encore terminée en raison d’un INSERT de longue durée qui crée une nouvelle partie de données devant être mutée.
  • parts_postpone_reasons (Map(String, String)) — Une correspondance entre les noms des parts et les raisons de leur report.
  • is_done (UInt8) — Indique si la mutation est terminée ou non. Valeurs possibles : 1 si la mutation est terminée, 0 si la mutation est toujours en cours.
  • is_killed (UInt8) — Indique si une mutation a été arrêtée. Disponible uniquement dans ClickHouse Cloud. Remarque : is_killed=1 ne signifie pas nécessairement que la mutation est complètement finalisée. Il est possible qu’une mutation reste pendant une période prolongée dans un état où is_killed=1 et is_done=0. Cela peut se produire si une autre mutation de longue durée bloque la mutation arrêtée. Il s’agit d’une situation normale.
  • latest_failed_part (String) — Le nom de la part la plus récente qui n’a pas pu être mutée.
  • latest_fail_time (DateTime) — La date et l’heure du dernier échec de mutation d’une part.
  • latest_fail_reason (String) — Le message d’exception à l’origine du dernier échec de mutation d’une part.
  • latest_fail_error_code_name (String) — Le code d’erreur de l’exception à l’origine du dernier échec de mutation d’une part.
  • Si un nom de part n’apparaît pas dans parts_postpone_reasons et n’a pas encore été muté, cela signifie que la part n’est pas encore planifiée pour une mutation.
  • Le nom de part all_parts représente toutes les parts qui n’ont pas encore été mutées.
  • is_killed (UInt8) — Indique si une mutation a été arrêtée. Disponible uniquement dans ClickHouse Cloud.
is_killed=1 ne signifie pas nécessairement que la mutation est entièrement finalisée. Il est possible qu’une mutation reste pendant une période prolongée dans un état où is_killed=1 et is_done=0. Cela peut se produire si une autre mutation de longue durée bloque la mutation arrêtée. Il s’agit d’une situation normale.
  • is_done (UInt8) — Indique si la mutation est terminée ou non. Valeurs possibles :
    • 1 si la mutation est terminée,
    • 0 si la mutation est toujours en cours.
Même si parts_to_do = 0, il est possible qu’une mutation d’une table répliquée ne soit pas encore terminée en raison d’une requête INSERT de longue durée, qui créera une nouvelle partie de données devant encore être traitée par la mutation.
Si des problèmes sont survenus lors de la mutation de certaines parties de données, les colonnes suivantes contiennent des informations supplémentaires :
  • latest_failed_part (String) — Le nom de la part la plus récente qui n’a pas pu être mutée.
  • latest_fail_time (DateTime) — La date et l’heure du plus récent échec de mutation d’une part.
  • latest_fail_reason (String) — Le message d’exception à l’origine du plus récent échec de mutation d’une part.

​
Suivi des mutations

Pour suivre la progression dans la table system.mutations, utilisez la requête suivante : 
SELECT * FROM clusterAllReplicas('cluster_name', 'system', 'mutations')
WHERE is_done = 0 AND table = 'tmp';

-- or

SELECT * FROM clusterAllReplicas('cluster_name', 'system.mutations')
WHERE is_done = 0 AND table = 'tmp';
Remarque : cela nécessite des droits de lecture sur les tables system.*.
Utilisation de CloudDans ClickHouse Cloud, la table system.mutations de chaque nœud contient toutes les mutations du cluster, et il n’est pas nécessaire d’utiliser clusterAllReplicas.

​
Voir aussi

Dernière modification le 25 juin 2026