Files
impala/docs/topics/impala_kill_query.xml
m-sanjana19 8a691a3507 IMPALA-12648: [DOCS] Documentation for Kill Query statements
Documents the Kill Query statements used to stop running queries
by using their unique query IDs.

Change-Id: I51efbdeb585bad358b3e44ea4f555f62bfee4f00
Reviewed-on: http://gerrit.cloudera.org:8080/23031
Reviewed-by: Impala Public Jenkins <impala-public-jenkins@cloudera.com>
Tested-by: Impala Public Jenkins <impala-public-jenkins@cloudera.com>
2025-07-21 02:23:18 +00:00

60 lines
2.6 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="impala_kill_query" rev="4.5.0 IMPALA-12648">
<title>KILL QUERY Statements</title>
<titlealts audience="PDF">
<navtitle>KILL QUERY</navtitle>
</titlealts>
<prolog>
<metadata>
<data name="Category" value="Impala"/>
<data name="Category" value="SQL"/>
<data name="Category" value="Kill Query"/>
<data name="Category" value="Data Analysts"/>
<data name="Category" value="Developers"/>
<data name="Category" value="Tables"/>
<data name="Category" value="ETL"/>
</metadata>
</prolog>
<conbody>
<p>The <codeph>KILL QUERY</codeph> statement allows you to programmatically terminate running
queries by specifying their query ids. This functionality helps manage workloads by enabling
users to cancel and unregister queries across any coordinator in the cluster.</p>
<p>
<b>Syntax:</b>
</p>
<codeblock id="codeblock_vjr_mry_52c">KILL QUERY '<varname>query_id</varname>';</codeblock>
<p>Replace '<varname>query_id</varname>' with the query id you want to terminate.</p>
<p><b>Example:</b></p>
<codeblock id="codeblock_jfk_sry_52c">KILL QUERY '123:456';</codeblock>
<p><varname>query_id</varname> represents a query that is currently executing in the system.</p>
<p><b>Required privileges</b>: Only administrators or query owners can execute <codeph>KILL
QUERY</codeph>.</p>
<p><b>Cancellation</b>: Cannot be cancelled.</p>
<p><b>Considerations</b>: If the specified query is not found on any of the coordinators in the
cluster, a <codeph>Could not find query on any coordinator</codeph> error is returned.</p>
<p>
<b>Added in:</b>
<keyword keyref="impala45"/>
</p>
</conbody>
</concept>