ClickHouse Mutation
在 ClickHouse 中，ALTER UPDATE/DELETE 等，被称为 Mutation。
一、Mutation 异步执行注意事项
Mutation 是异步执行的，所以如果有后续任何类型的 Query，无论是INSERT、SELECT、ALTER等，如果这些 Query 的条件对 Mutation 的结果有依赖，那么都应该等待 Mutation 完全结束之后再操作。
确认 Mutation 是否完成，可以通过查询system.mutations表中是否有相关的”is_done=0″记录来完成。
检测是否有未完成的 Mutations：
SELECT COUNT() FROM `system`.mutations
WHERE `database`='${db_name}' AND `table`='${tbl_name}' AND is_done=0;
二、删除挂起的 Mutation
某同学曾经在ALTER UPDATE中错误地赋值，将NULL赋给不可为NULL的字段，从而使 Mutation 无法正确执行，然后就一直挂在系统里，而且不断报错。
2019.09.05 10:46:11.450867 [ 9 ] {} <Error> db_name.tbl_name: DB::StorageReplicatedMergeTree::queueTask()::<lambda(DB::StorageReplicatedMergeTree::LogEntryPtr&)>: Code: 349, e.displayText() = DB::Exception: Cannot convert NULL value to non-Nullable type, Stack trace:
此时便需要将挂起的 Mutation 清理掉。
首先，通过
SELECT * FROM `system`.mutations
WHERE `database`='${db_name}' AND `table`='${tbl_name}' AND is_done=0;
查得与挂起 Mutation 相关记录的mutation_id字段值等相关信息。然后进行清理。
清理有两种手法：
1. 系统自带清理
语法：
KILL MUTATION [ON CLUSTER cluster]
WHERE <where expression to SELECT FROM system.mutations query>
[TEST]
[FORMAT format]
例子：
-- 取消并移除某单表的所有 Mutations：
KILL MUTATION WHERE database = '${db_name}' AND table = '${tbl_name}'
-- 取消某特定的 Mutation：
KILL MUTATION WHERE database = '${db_name}' AND table = '${tbl_name}' AND mutation_id = '${mutation_id}'
官方文档参考：KILL MUTATION
2. 手工清理
有两种 Case，一种是复制表，一种是非复制表。
2.1 对于复制表，处理 ZooKeeper 中相应的 ZNode 即可。
在 ZooKeeper 中找到znode /${path_to_table}/mutations/${mutation_id}，将其删除。
2.2 对于非复制表
先将表卸载：
DETACH TABLE `${tbl_name}`;
从 ${clickhouse_data_dir}/${db_name}/${tbl_name}/ 目录中，删除 mutation_${mutation_id}.txt 文件。
重新装载表：
ATTACH TABLE `${tbl_name}`;
