This is an automated email from the ASF dual-hosted git repository.
stigahuang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/impala.git
The following commit(s) were added to refs/heads/master by this push:
new 8a691a350 IMPALA-12648: [DOCS] Documentation for Kill Query statements
8a691a350 is described below
commit 8a691a350756d7b2f854a9da0585adb944081c6f
Author: m-sanjana19 <[email protected]>
AuthorDate: Mon Jun 16 12:21:02 2025 +0530
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 <[email protected]>
Tested-by: Impala Public Jenkins <[email protected]>
---
docs/impala.ditamap | 1 +
docs/topics/impala_kill_query.xml | 59 +++++++++++++++++++++++++++++++++++++++
2 files changed, 60 insertions(+)
diff --git a/docs/impala.ditamap b/docs/impala.ditamap
index cbd1279f9..728979cbc 100644
--- a/docs/impala.ditamap
+++ b/docs/impala.ditamap
@@ -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"/>
diff --git a/docs/topics/impala_kill_query.xml
b/docs/topics/impala_kill_query.xml
new file mode 100644
index 000000000..ff04e583e
--- /dev/null
+++ b/docs/topics/impala_kill_query.xml
@@ -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>
