system.mutations

Table système contenant des informations sur les mutations des tables MergeTree et leur avancement. Chaque commande de mutation est représentée par une seule ligne.

​

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 de znode 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 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 par 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 par partition, avec le numéro de bloc obtenu par la mutation. Dans chaque partition, seules les parties contenant des blocs dont le numéro est inférieur à ce numéro seront mutées. Dans les tables non répliquées, les numéros de bloc de toutes les partitions forment une seule séquence. Par conséquent, pour les mutations de tables non répliquées, la colonne contient un enregistrement avec un unique 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, une mutation d’une table répliquée peut ne pas être encore terminée en raison d’un INSERT de longue durée créant une nouvelle partie de données qui devra être mutée.
• parts_postpone_reasons (Map(String, String)) — Une map associant les noms des parties aux raisons de leur report.
• is_done (UInt8) — Indique si la mutation est terminée. Valeurs possibles : 1 si la mutation est terminée, 0 si elle 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 entièrement finalisée. Une mutation peut rester longtemps 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 dernière partie qui n’a pas pu être mutée.
• latest_fail_time (DateTime) — La date et l’heure du dernier échec de mutation d’une partie.
• latest_fail_reason (String) — Le message d’exception à l’origine du dernier échec de mutation d’une partie.
• latest_fail_error_code_name (String) — Le code d’erreur de l’exception à l’origine du dernier échec de mutation d’une partie.

• Si un nom de partie de données ne figure pas dans parts_postpone_reasons et n’a pas encore été muté, cela signifie que la partie de données n’est pas encore planifiée pour une mutation.
• Le nom de partie de données all_parts représente toutes les parties de données 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 terminée. Une mutation peut rester longtemps 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 partie de données 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 partie de données.
• latest_fail_reason (String) — Le message d’exception à l’origine du plus récent échec de mutation d’une partie de données.

​

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 Cloud

Dans 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

• Mutations
• moteur de table MergeTree
• famille ReplicatedMergeTree