This is an automated email from the ASF dual-hosted git repository.
924060929 pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new ab9b22f4fed [fix][doc] quote the session_context value in kill-query
SET_VAR hint example (#3938)
ab9b22f4fed is described below
commit ab9b22f4fedfa35301cacdd112a50f57d19ff938
Author: 924060929 <[email protected]>
AuthorDate: Wed Jun 17 14:40:32 2026 +0800
[fix][doc] quote the session_context value in kill-query SET_VAR hint
example (#3938)
The per-query `SET_VAR` hint example in kill-query used an unquoted
`session_context` value. Since the value contains `:`, it must be quoted
— otherwise the hint truncates the value at the colon and the trace_id
is lost (the session-level `SET` example above already uses quotes).
Updated the example in current / 3.0 / 2.1 docs (English + Chinese).
Related: apache/doris#64569
---
docs/admin-manual/workload-management/kill-query.md | 4 ++--
.../current/admin-manual/workload-management/kill-query.md | 4 ++--
.../version-2.1/admin-manual/workload-management/kill-query.md | 2 +-
.../version-3.x/admin-manual/workload-management/kill-query.md | 2 +-
.../version-4.x/admin-manual/workload-management/kill-query.md | 4 ++--
.../current/admin-manual/workload-management/kill-query.md | 2 +-
.../version-2.1/admin-manual/workload-management/kill-query.md | 2 +-
.../version-3.x/admin-manual/workload-management/kill-query.md | 2 +-
.../version-4.x/admin-manual/workload-management/kill-query.md | 2 +-
.../version-2.1/admin-manual/workload-management/kill-query.md | 2 +-
.../version-3.x/admin-manual/workload-management/kill-query.md | 2 +-
.../version-4.x/admin-manual/workload-management/kill-query.md | 4 ++--
12 files changed, 16 insertions(+), 16 deletions(-)
diff --git a/docs/admin-manual/workload-management/kill-query.md
b/docs/admin-manual/workload-management/kill-query.md
index 74a03eac284..fc8f7f8c924 100644
--- a/docs/admin-manual/workload-management/kill-query.md
+++ b/docs/admin-manual/workload-management/kill-query.md
@@ -85,7 +85,7 @@ SET session_context = "trace_id:your_trace_id";
You can also set it through a Hint on a single query statement, without
modifying the session variable:
```sql
-SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table ...;
+SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table ...;
```
## Execute the KILL Operation
@@ -153,7 +153,7 @@ There are two ways to bind the Trace ID:
- Embed a Hint in the query statement (suitable for connection-pool reuse
scenarios):
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table
...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table
...;
```
Once bound, cancel the query at any time with the following command:
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
index d1b7181c8e9..39f0eefa009 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
@@ -85,7 +85,7 @@ SET session_context = "trace_id:your_trace_id";
也可在单条查询语句中通过 Hint 设置，无需修改会话变量：
```sql
-SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table ...;
+SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table ...;
```
## 执行 KILL 操作
@@ -153,7 +153,7 @@ KILL 55;
- 在查询语句中内嵌 Hint（适合连接池复用场景）：
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table
...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table
...;
```
绑定后，可在任意时刻通过以下命令取消该查询：
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
index 6e6abc30931..cbe164218e5 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
@@ -150,7 +150,7 @@ KILL [CONNECTION] connection_id;
- 在查询语句中添加 Trace ID
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
之后，管控工具可以通过 Trace ID 随时取消正在执行的操作。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
index 6e6abc30931..cbe164218e5 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
@@ -150,7 +150,7 @@ KILL [CONNECTION] connection_id;
- 在查询语句中添加 Trace ID
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
之后，管控工具可以通过 Trace ID 随时取消正在执行的操作。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
index d1b7181c8e9..39f0eefa009 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
@@ -85,7 +85,7 @@ SET session_context = "trace_id:your_trace_id";
也可在单条查询语句中通过 Hint 设置，无需修改会话变量：
```sql
-SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table ...;
+SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table ...;
```
## 执行 KILL 操作
@@ -153,7 +153,7 @@ KILL 55;
- 在查询语句中内嵌 Hint（适合连接池复用场景）：
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table
...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table
...;
```
绑定后，可在任意时刻通过以下命令取消该查询：
diff --git
a/ja-source/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
b/ja-source/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
index bd97debafab..514533a0f1b 100644
---
a/ja-source/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
+++
b/ja-source/docusaurus-plugin-content-docs/current/admin-manual/workload-management/kill-query.md
@@ -141,6 +141,6 @@ KILL [CONNECTION] connection_id;
- クエリ文にTrace IDを追加する
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
その後、管理システムはTrace IDを使用していつでも実行中のオペレーションをキャンセルできます。
diff --git
a/ja-source/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
b/ja-source/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
index 6b1e79e4493..f7f8b8955d3 100644
---
a/ja-source/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
+++
b/ja-source/docusaurus-plugin-content-docs/version-2.1/admin-manual/workload-management/kill-query.md
@@ -141,6 +141,6 @@ KILL [CONNECTION] connection_id;
- クエリステートメントにTrace IDを追加する
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
その後、管理システムはTrace IDを使用して、実行中の操作をいつでもキャンセルできます。
diff --git
a/ja-source/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
b/ja-source/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
index b0f8b55b2ef..98aef56c39a 100644
---
a/ja-source/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
+++
b/ja-source/docusaurus-plugin-content-docs/version-3.x/admin-manual/workload-management/kill-query.md
@@ -141,6 +141,6 @@ KILL [CONNECTION] connection_id;
- クエリステートメントにTrace IDを追加する
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
その後、管理システムはTrace IDを使用して実行中の操作をいつでもキャンセルできます。
diff --git
a/ja-source/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
b/ja-source/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
index e5f790ea811..2ffa3783f76 100644
---
a/ja-source/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
+++
b/ja-source/docusaurus-plugin-content-docs/version-4.x/admin-manual/workload-management/kill-query.md
@@ -141,6 +141,6 @@ KILL [CONNECTION] connection_id;
- クエリ文にTrace IDを追加する
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
その後、管理システムはTrace IDを使用して実行中のオペレーションをいつでもキャンセルできます。
diff --git
a/versioned_docs/version-2.1/admin-manual/workload-management/kill-query.md
b/versioned_docs/version-2.1/admin-manual/workload-management/kill-query.md
index f912d87a47e..afade956871 100644
--- a/versioned_docs/version-2.1/admin-manual/workload-management/kill-query.md
+++ b/versioned_docs/version-2.1/admin-manual/workload-management/kill-query.md
@@ -150,7 +150,7 @@ The `CONNECTION` keyword can be omitted.
- Add Trace ID in the query statement
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
Afterward, management system can cancel running operations at any time
using the Trace ID.
diff --git
a/versioned_docs/version-3.x/admin-manual/workload-management/kill-query.md
b/versioned_docs/version-3.x/admin-manual/workload-management/kill-query.md
index f912d87a47e..afade956871 100644
--- a/versioned_docs/version-3.x/admin-manual/workload-management/kill-query.md
+++ b/versioned_docs/version-3.x/admin-manual/workload-management/kill-query.md
@@ -150,7 +150,7 @@ The `CONNECTION` keyword can be omitted.
- Add Trace ID in the query statement
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ *
FROM table ...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ *
FROM table ...;
```
Afterward, management system can cancel running operations at any time
using the Trace ID.
diff --git
a/versioned_docs/version-4.x/admin-manual/workload-management/kill-query.md
b/versioned_docs/version-4.x/admin-manual/workload-management/kill-query.md
index 74a03eac284..fc8f7f8c924 100644
--- a/versioned_docs/version-4.x/admin-manual/workload-management/kill-query.md
+++ b/versioned_docs/version-4.x/admin-manual/workload-management/kill-query.md
@@ -85,7 +85,7 @@ SET session_context = "trace_id:your_trace_id";
You can also set it through a Hint on a single query statement, without
modifying the session variable:
```sql
-SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table ...;
+SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table ...;
```
## Execute the KILL Operation
@@ -153,7 +153,7 @@ There are two ways to bind the Trace ID:
- Embed a Hint in the query statement (suitable for connection-pool reuse
scenarios):
```sql
- SELECT /*+SET_VAR(session_context=trace_id:your_trace_id)*/ * FROM table
...;
+ SELECT /*+SET_VAR(session_context="trace_id:your_trace_id")*/ * FROM table
...;
```
Once bound, cancel the query at any time with the following command:
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
