KILL 语句

有两种类型的终止语句：用于终止查询和用于终止变更

KILL QUERY

KILL QUERY [ON CLUSTER cluster]
  WHERE <where expression to SELECT FROM system.processes query>
  [SYNC|ASYNC|TEST]
  [FORMAT format]

尝试强制终止当前正在运行的查询。要终止的查询是从 system.processes 表中选择的，使用 KILL 查询的 WHERE 子句中定义的标准。

示例：

首先，您需要获取未完成查询的列表。此 SQL 查询根据运行时间最长的查询提供它们：

从单个 ClickHouse 节点列表：

SELECT
  initial_query_id,
  query_id,
  formatReadableTimeDelta(elapsed) AS time_delta,
  query,
  *
  FROM system.processes
  WHERE query ILIKE 'SELECT%'
  ORDER BY time_delta DESC;

从 ClickHouse 集群列表：

SELECT
  initial_query_id,
  query_id,
  formatReadableTimeDelta(elapsed) AS time_delta,
  query,
  *
  FROM clusterAllReplicas(default, system.processes)
  WHERE query ILIKE 'SELECT%'
  ORDER BY time_delta DESC;

终止查询：

-- Forcibly terminates all queries with the specified query_id:
KILL QUERY WHERE query_id='2-857d-4a57-9ee0-327da5d60a90'

-- Synchronously terminates all queries run by 'username':
KILL QUERY WHERE user='username' SYNC

提示

如果您在 ClickHouse Cloud 或自管理集群中终止查询，请务必使用 ON CLUSTER [cluster-name] 选项，以确保在所有副本上终止该查询。

只读用户只能停止自己的查询。

默认情况下，使用的是查询的异步版本（ASYNC），这不会等待查询停止的确认。

同步版本（SYNC）会等待所有查询停止，并在每个进程停止时显示相关信息。响应包含 kill_status 列，可能取值如下：

finished – 查询成功终止。
waiting – 等待查询结束，在发送终止信号后。
其他值解释了查询无法停止的原因。

测试查询（TEST）仅检查用户的权限并显示要停止的查询列表。

KILL MUTATION

长时间运行或未完成的变更的存在通常表明 ClickHouse 服务运行不良。变更的异步特性可能导致它们消耗系统中的所有可用资源。您可能需要：

暂停所有新变更、INSERT 和 SELECT ，并允许变更队列完成。
或者通过发送 KILL 命令手动终止其中一些变更。

KILL MUTATION
  WHERE <where expression to SELECT FROM system.mutations query>
  [TEST]
  [FORMAT format]

尝试取消和移除当前正在执行的变更。要取消的变更是从 system.mutations 表中选择的，使用 KILL 查询的 WHERE 子句中指定的过滤器。

测试查询（TEST）仅检查用户的权限并显示要停止的变更列表。

示例：

获取未完成变更的 count() 数量：

从单个 ClickHouse 节点的变更计数：

SELECT count(*)
FROM system.mutations
WHERE is_done = 0;

从 ClickHouse 副本集群的变更计数：

SELECT count(*)
FROM clusterAllReplicas('default', system.mutations)
WHERE is_done = 0;

查询未完成变更的列表：

从单个 ClickHouse 节点的变更列表：

SELECT mutation_id, *
FROM system.mutations
WHERE is_done = 0;

从 ClickHouse 集群的变更列表：

SELECT mutation_id, *
FROM clusterAllReplicas('default', system.mutations)
WHERE is_done = 0;

根据需要终止变更：

-- Cancel and remove all mutations of the single table:
KILL MUTATION WHERE database = 'default' AND table = 'table'

-- Cancel the specific mutation:
KILL MUTATION WHERE database = 'default' AND table = 'table' AND mutation_id = 'mutation_3.txt'

当变更被卡住并无法完成时（例如，如果变更查询中的某些函数对表中包含的数据应用时抛出异常），该查询非常有用。

变更已经做出的更改不会被回滚。

备注

is_killed=1 列（仅 ClickHouse Cloud）在 system.mutations 表中不一定意味着变更已完全完成。变更可能保持在 is_killed=1 和 is_done=0 的状态中，持续一段时间。如果另一个长时间运行的变更阻止了被终止的变更，这种情况是正常的。

KILL QUERY​

KILL MUTATION​

KILL QUERY

KILL MUTATION