Skip to content

Commit 2d9f6d5

Browse files
authored
Update _avoid_mutations.md
1 parent 55f148d commit 2d9f6d5

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

docs/best-practices/_snippets/_avoid_mutations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ When a mutation is issued, ClickHouse schedules the creation of new **mutated pa
77
For large datasets, this can produce a substantial spike in disk I/O and degrade overall cluster performance. Unlike merges, mutations can't be rolled back once submitted and will continue to execute even after server restarts unless explicitly cancelled—see [`KILL MUTATION`](/sql-reference/statements/kill#kill-mutation).
88

99
:::tip Monitoring the number of active or queued mutations in ClickHouse
10-
For how to monitor the number of active or queued mutations refer to the following ["KB article"](/knowledgebase/view_number_of_active_mutations).
10+
For how to monitor the number of active or queued mutations refer to the following [knowledge base article](/knowledgebase/view_number_of_active_mutations).
1111
:::
1212

1313
Mutations are **totally ordered**: they apply to data inserted before the mutation was issued, while newer data remains unaffected. They do not block inserts but can still overlap with other ongoing queries. A SELECT running during a mutation may read a mix of mutated and unmutated parts, which can lead to inconsistent views of the data during execution. ClickHouse executes mutations in parallel per part, which can further intensify memory and CPU usage, especially when complex subqueries (like x IN (SELECT ...)) are involved.

0 commit comments

Comments
 (0)