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>
This commit is contained in:
m-sanjana19
2025-06-16 12:21:02 +05:30
committed by Impala Public Jenkins
parent d5f7cc3a0b
commit 8a691a3507
2 changed files with 60 additions and 0 deletions

View File

@@ -158,6 +158,7 @@ under the License.
<topicref href="topics/impala_grant.xml"/>
<topicref href="topics/impala_insert.xml"/>
<topicref href="topics/impala_invalidate_metadata.xml"/>
<topicref href="topics/impala_kill_query.xml"/>
<topicref href="topics/impala_load_data.xml"/>
<topicref href="topics/impala_merge.xml"/>
<topicref href="topics/impala_refresh.xml"/>

View File

@@ -0,0 +1,59 @@
<?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>