ClickHouse执行ALTER DELETE返回OK却未删除数据的原因与解决办法

• 异步mutation执行延迟：ClickHouse的ALTER DELETE属于异步mutation操作，返回Ok仅代表删除任务已提交到后台队列，不代表任务执行完成。21.2版本相对于20.11版本调整了默认的mutation调度策略，对低优先级mutation的执行延后更长，若提交任务后立即查询数据，会出现数据未删除的假象。
• mutation执行异常未同步报错：如果删除任务涉及的分区存在损坏、副本同步异常、磁盘权限不足等问题，mutation会进入失败状态，但前台提交语句时依然会返回Ok，不会同步返回错误信息。
• 配置参数mutations_sync默认值为0：该参数控制mutation执行的同步策略，默认值0代表完全异步，提交后立即返回；值为1代表等待当前节点执行完成再返回；值为2代表等待所有副本节点执行完成再返回。若20.11环境修改过该参数默认值，21.2环境使用默认配置，就会出现两个环境执行效果感知不一致的问题。
• 分布式表操作未指定集群：如果操作的是分布式表，21.2版本默认不会自动下发mutation到集群所有节点，仅执行当前节点的删除任务，导致全局查询时数据没有被删除。

• 等待mutation执行完成后再校验结果：提交删除语句后，执行SELECT * FROM system.mutations WHERE table = 'mytable' AND database = '替换为你的数据库名'查看任务状态，当is_done字段值为1时代表任务执行完成，此时再校验数据是否删除即可。
• 调整同步策略避免异步延迟：如果需要同步等待删除执行完成，执行语句时新增参数设置：

ALTER TABLE mytable DELETE WHERE myid = 42 SETTINGS mutations_sync = 1

执行完成后再查询即可看到删除结果。

• 排查失败的mutation任务：如果查询system.mutations表发现任务latest_fail_reason字段存在报错信息，根据报错内容处理对应问题（比如修复损坏分区、调整磁盘权限、修复副本同步状态），之后重新执行删除语句即可。
• 手动触发mutation执行：如果任务长时间处于排队状态，可执行SYSTEM RUN MUTATIONS 替换为你的数据库名.mytable手动触发待执行的mutation任务。
• 分布式表场景补充配置：如果操作的是分布式表，删除语句需要指定集群名，确保删除任务下发到所有分片节点执行：

ALTER TABLE mytable ON CLUSTER 替换为你的集群名 DELETE WHERE myid = 42

内容的提问来源于stack exchange，提问作者Sheldon