Repository: StarRocks/starrocks
Pull request #56544: [Doc]rename configuartion to take charge of all query-trigger tasks
Author: login: zombee0
Labels: name: documentation
description: Improvements or additions to documentation
name: 3.4-merged
Created: 2025-03-04T06:51:07Z | Merged: 2025-03-10T08:55:13Z

## Why I'm doing:

## What I'm doing:

Fixes #issue

## What type of PR is this:

- [ ] BugFix
- [ ] Feature
- [ ] Enhancement
- [ ] Refactor
- [ ] UT
- [x] Doc
- [ ] Tool

Does this PR entail a change in behavior?

- [x] Yes, this PR will result in a change in behavior.
- [ ] No, this PR will not result in a change in behavior.

If yes, please specify the type of change:

- [ ] Interface/UI changes: syntax, type conversion, expression evaluation, display information
- [ ] Parameter changes: default values, similar parameters but with different default values
- [ ] Policy changes: use new policy to replace old one, functionality automatically enabled
- [ ] Feature removed
- [ ] Miscellaneous: upgrade & downgrade compatibility, etc.

## Checklist:

- [ ] I have added test cases for my bug fix or my new feature
- [ ] This pr needs user documentation (for new or modified features or behaviors)
  - [ ] I have added documentation for my new feature or new function
- [ ] This is a backport pr

## Bugfix cherry-pick branch check:
- [x] I have checked the version labels which the pr will be auto-backported to the target branch
  - [x] 3.4
  - [ ] 3.3
  - [ ] 3.2
  - [ ] 3.1
  - [ ] 3.0


Diff:
diff --git a/docs/en/administration/management/FE_configuration.md b/docs/en/administration/management/FE_configuration.md
index ebef08e9926eaa..6cb308061f8394 100644
--- a/docs/en/administration/management/FE_configuration.md
+++ b/docs/en/administration/management/FE_configuration.md
@@ -1797,6 +1797,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: The maximum number of rows to collect for a histogram.
 - Introduced in: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- Default: 30
+- Type: Int
+- Unit: Second
+- Is mutable: Yes
+- Description: The interval at which the Scheduler thread schedules the query-trigger background tasks. This item is to replace `connector_table_query_trigger_analyze_schedule_interval` introduced in v3.4.0. Here, the background tasks refer `ANALYZE` tasks in v3.4，and the collection task of low-cardinality columns' dictionary in versions later than v3.4.  
+- Introduced in: v3.4.2
+
 ##### connector_table_query_trigger_analyze_small_table_rows
 
 - Default: 10000000
@@ -1833,15 +1842,6 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: Maximum number of query-trigger ANALYZE tasks that are in Pending state on the FE.
 - Introduced in: v3.4.0
 
-##### connector_table_query_trigger_analyze_schedule_interval
-
-- Default: 30
-- Type: Int
-- Unit: Second
-- Is mutable: Yes
-- Description: The interval at which the Scheduler thread schedules to query-trigger ANALYZE tasks.
-- Introduced in: v3.4.0
-
 ##### connector_table_query_trigger_analyze_max_running_task_num
 
 - Default: 2
diff --git a/docs/ja/administration/management/FE_configuration.md b/docs/ja/administration/management/FE_configuration.md
index d9226c9976629e..43e00c2ec13436 100644
--- a/docs/ja/administration/management/FE_configuration.md
+++ b/docs/ja/administration/management/FE_configuration.md
@@ -1176,6 +1176,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: ヒストグラムのために収集する最大行数。
 - 導入バージョン: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- デフォルト: 30
+- タイプ: Int
+- 単位: 秒
+- 変更可能: はい
+- 説明: Scheduler スレッドがクエリトリガーのバックグラウンドタスクをスケジュールする間隔。この項目は v3.4.0 で導入された `connector_table_query_trigger_analyze_schedule_interval` を置き換えるものである。ここで、バックグラウンドタスクとは、v3.4 では `ANALYZE` タスク、v3.4 より後のバージョンでは低カーディナリティ列の辞書のコレクションタスクを指す。
+- 導入バージョン: v3.4.2
+
 ##### connector_table_query_trigger_analyze_small_table_rows
 
 - デフォルト: 10000000
@@ -1212,15 +1221,6 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: FE 上で保留状態のクエリトリガー分析タスクの最大数。
 - 導入バージョン: v3.4.0
 
-##### connector_table_query_trigger_analyze_schedule_interval
-
-- デフォルト: 30
-- タイプ: Int
-- 単位: 秒
-- 変更可能: はい
-- 説明: スケジューラースレッドがクエリトリガー分析タスクをスケジュールする間隔。
-- 導入バージョン: v3.4.0
-
 ##### connector_table_query_trigger_analyze_max_running_task_num
 
 - デフォルト: 2
diff --git a/docs/zh/administration/management/FE_configuration.md b/docs/zh/administration/management/FE_configuration.md
index a47a0597be7c84..f7d336397656a5 100644
--- a/docs/zh/administration/management/FE_configuration.md
+++ b/docs/zh/administration/management/FE_configuration.md
@@ -1789,6 +1789,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 描述：直方图最大采样行数。
 - 引入版本：-
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- 默认值：30
+- 类型：Int
+- 单位：秒
+- 是否动态：是
+- 描述：Schedule 线程调度查询触发的后台任务的周期。该项用于取代 v3.4.0 中引入的 `connector_table_query_trigger_analyze_schedule_interval`。此处后台任务是指 v3.4 中的 `ANALYZE` 任务，以及 v3.4 之后版本中引入的低基数列字典的收集任务。
+- 引入版本：v3.4.2
+
 ##### connector_table_query_trigger_analyze_small_table_rows
 
 - 默认值：10000000
@@ -1825,15 +1834,6 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 描述：FE 中处于 Pending 状态的查询触发 ANALYZE 任务的最大数量。
 - 引入版本：v3.4.0
 
-##### connector_table_query_trigger_analyze_schedule_interval
-
-- 默认值：30
-- 类型：Int
-- 单位：秒
-- 是否动态：是
-- 描述：Schedule 线程调度查询触发 ANALYZE 任务的周期。
-- 引入版本：v3.4.0
-
 ##### connector_table_query_trigger_analyze_max_running_task_num
 
 - 默认值：2
diff --git a/fe/fe-core/src/main/java/com/starrocks/common/Config.java b/fe/fe-core/src/main/java/com/starrocks/common/Config.java
index 570591f4fbc2af..e99689abbcee29 100644
--- a/fe/fe-core/src/main/java/com/starrocks/common/Config.java
+++ b/fe/fe-core/src/main/java/com/starrocks/common/Config.java
@@ -2219,7 +2219,7 @@ public class Config extends ConfigBase {
     public static long connector_table_query_trigger_analyze_max_pending_task_num = 100;
 
     @ConfField(mutable = true)
-    public static long connector_table_query_trigger_analyze_schedule_interval = 30; // unit: second, default 30s
+    public static long connector_table_query_trigger_task_schedule_interval = 30; // unit: second, default 30s
 
     /**
      * If set to true, Planner will try to select replica of tablet on same host as this Frontend.
diff --git a/fe/fe-core/src/main/java/com/starrocks/connector/statistics/ConnectorTableTriggerAnalyzeMgr.java b/fe/fe-core/src/main/java/com/starrocks/connector/statistics/ConnectorTableTriggerAnalyzeMgr.java
index 0c313751666163..0fa067e38cd52b 100644
--- a/fe/fe-core/src/main/java/com/starrocks/connector/statistics/ConnectorTableTriggerAnalyzeMgr.java
+++ b/fe/fe-core/src/main/java/com/starrocks/connector/statistics/ConnectorTableTriggerAnalyzeMgr.java
@@ -48,7 +48,7 @@ public class ConnectorTableTriggerAnalyzeMgr {
     public void start() {
         if (isStart.compareAndSet(false, true)) {
             dispatchScheduler.scheduleAtFixedRate(this::schedulePendingTask, 0,
-                    Config.connector_table_query_trigger_analyze_schedule_interval, TimeUnit.SECONDS);
+                    Config.connector_table_query_trigger_task_schedule_interval, TimeUnit.SECONDS);
         }
     }
 


Reviews:
user: login: DorianZheng
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T02:03:21Z
user: login: Youngwb
state: DISMISSED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T02:03:47Z
user: login: zombee0
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T02:41:38Z
user: login: zombee0
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T02:42:16Z
user: login: wangsimo0
state: DISMISSED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T02:43:19Z
user: login: DorianZheng
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T06:35:56Z
user: login: EsoragotoSpirit
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T06:38:19Z
user: login: EsoragotoSpirit
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T06:48:53Z
user: login: EsoragotoSpirit
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T06:50:35Z
user: login: EsoragotoSpirit
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T06:51:54Z
user: login: Youngwb
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-05T11:21:05Z
user: login: DorianZheng
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-10T08:12:49Z

Review comments:
diff_hunk: @@ -1176,6 +1176,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: ヒストグラムのために収集する最大行数。
 - 導入バージョン: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- デフォルト: 30
path: docs/ja/administration/management/FE_configuration.md
user: login: DorianZheng
body: Amazing! I didn't even know you spoke Japanese.🫠
created_at: 2025-03-05T02:01:46Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1797,6 +1797,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: The maximum number of rows to collect for a histogram.
 - Introduced in: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- Default: 30
+- Type: Int
+- Unit: Second
+- Is mutable: Yes
+- Description: The interval at which the Scheduler thread schedules to query-trigger tasks. We changed `connector_table_query_trigger_analyze_schedule_interval` to this which takes charge of all background tasks. The background tasks are `ANALYZE` in v3.4.x，and in versions after 3.4, the collection task of low-cardinality columns' dictionary is added.  
path: docs/en/administration/management/FE_configuration.md
user: login: DorianZheng
body: What exactly is the definition of `query-tigger` tasks? Should we elaborate it a little bit on somewhere
created_at: 2025-03-05T02:03:16Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1176,6 +1176,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: ヒストグラムのために収集する最大行数。
 - 導入バージョン: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- デフォルト: 30
path: docs/ja/administration/management/FE_configuration.md
user: login: zombee0
body: @DorianZheng I can't speak Japanese， I did this by chatgpt, and Document team will help to refine it.
created_at: 2025-03-05T02:41:38Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1797,6 +1797,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: The maximum number of rows to collect for a histogram.
 - Introduced in: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- Default: 30
+- Type: Int
+- Unit: Second
+- Is mutable: Yes
+- Description: The interval at which the Scheduler thread schedules to query-trigger tasks. We changed `connector_table_query_trigger_analyze_schedule_interval` to this which takes charge of all background tasks. The background tasks are `ANALYZE` in v3.4.x，and in versions after 3.4, the collection task of low-cardinality columns' dictionary is added.  
path: docs/en/administration/management/FE_configuration.md
user: login: zombee0
body: Let me talk about it with Document Team
created_at: 2025-03-05T02:42:16Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1176,6 +1176,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: ヒストグラムのために収集する最大行数。
 - 導入バージョン: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- デフォルト: 30
path: docs/ja/administration/management/FE_configuration.md
user: login: DorianZheng
body: I know. Just kidding
created_at: 2025-03-05T06:35:56Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1797,6 +1797,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - Description: The maximum number of rows to collect for a histogram.
 - Introduced in: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- Default: 30
+- Type: Int
+- Unit: Second
+- Is mutable: Yes
+- Description: The interval at which the Scheduler thread schedules to query-trigger tasks. We changed `connector_table_query_trigger_analyze_schedule_interval` to this which takes charge of all background tasks. The background tasks are `ANALYZE` in v3.4.x，and in versions after 3.4, the collection task of low-cardinality columns' dictionary is added.  
path: docs/en/administration/management/FE_configuration.md
user: login: EsoragotoSpirit
body: ```suggestion
- Description: The interval at which the Scheduler thread schedules the query-trigger background tasks. This item is to replace `connector_table_query_trigger_analyze_schedule_interval` introduced in v3.4.0. Here, the background tasks refer `ANALYZE` tasks in v3.4，and the collection task of low-cardinality columns' dictionary in versions later than v3.4.  
```
created_at: 2025-03-05T06:38:19Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1789,6 +1789,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 描述：直方图最大采样行数。
 - 引入版本：-
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- 默认值：30
+- 类型：Int
+- 单位：秒
+- 是否动态：是
+- 描述：Schedule 线程调度查询触发的后台任务的周期。我们将 “connector_table_query_trigger_analyze_schedule_interval” 改为了这个参数，它负责所有的后台任务。在 3.4版本中，后台任务是`ANALYZE`，在 3.4 版本之后，又增加了低基数字典收集任务。
path: docs/zh/administration/management/FE_configuration.md
user: login: EsoragotoSpirit
body: ```suggestion
- 描述：Schedule 线程调度查询触发的后台任务的周期。该项用于取代 v3.4.0 中引入的 `connector_table_query_trigger_analyze_schedule_interval`。此处后台任务是指 v3.4 中的 `ANALYZE` 任务，以及 v3.4 之后版本中引入的低基数列字典的收集任务。
```
created_at: 2025-03-05T06:48:53Z
author_association: CONTRIBUTOR
diff_hunk: @@ -1176,6 +1176,15 @@ ADMIN SET FRONTEND CONFIG ("key" = "value");
 - 説明: ヒストグラムのために収集する最大行数。
 - 導入バージョン: -
 
+##### connector_table_query_trigger_task_schedule_interval
+
+- デフォルト: 30
+- タイプ: Int
+- 単位: 秒
+- 変更可能: はい
+- 説明: スケジューラースレッドがクエリトリガータスクをスケジュールする間隔。私たちは`connector_table_query_trigger_analyze_schedule_interval`をこのパラメータに変更しました。このパラメータはすべてのバックグラウンドタスクを担当しています。バージョン 3.4 では、バックグラウンドタスクは`ANALYZE`で、バージョン 3.4 以降では、低基数字典収集タスクが追加されました。
path: docs/ja/administration/management/FE_configuration.md
user: login: EsoragotoSpirit
body: ```suggestion
- 説明: Scheduler スレッドがクエリトリガーのバックグラウンドタスクをスケジュールする間隔。この項目は v3.4.0 で導入された `connector_table_query_trigger_analyze_schedule_interval` を置き換えるものである。ここで、バックグラウンドタスクとは、v3.4 では `ANALYZE` タスク、v3.4 より後のバージョンでは低カーディナリティ列の辞書のコレクションタスクを指す。
```
created_at: 2025-03-05T06:50:35Z
author_association: CONTRIBUTOR

PR comments:
user: login: sonarqubecloud[bot]
created_at: 2025-03-10T05:52:23Z
body: ## [![Quality Gate Failed](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/checks/QualityGateBadge/qg-failed-20px.png 'Quality Gate Failed')](https://sonarcloud.io/dashboard?id=StarRocks_starrocks&pullRequest=56544) **Quality Gate failed**  
Failed conditions  
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/failed-16px.png '') [B Maintainability Rating on New Code](https://sonarcloud.io/dashboard?id=StarRocks_starrocks&pullRequest=56544) (required ≥ A)  
  
[See analysis details on SonarQube Cloud](https://sonarcloud.io/dashboard?id=StarRocks_starrocks&pullRequest=56544)

##   
![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/light_bulb-16px.png '') Catch issues before they fail your Quality Gate with our IDE extension ![](https://sonarsource.github.io/sonarcloud-github-static-resources/v2/common/sonarlint-16px.png '') [SonarQube for IDE](https://www.sonarsource.com/products/sonarlint/features/connected-mode/?referrer=pull-request)


author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-10T07:26:14Z
body: #### [Java-Extensions Incremental Coverage Report]


:white_check_mark: **pass** : 0 / 0 (0%)




author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-10T07:26:49Z
body: #### [FE Incremental Coverage Report]

:white_check_mark: **pass** : 1 / 1 (100.00%)




#### file detail

|   |path|covered_line|new_line|coverage|not_covered_line_detail|
|----|----|----|----|----|----|
|:large_blue_circle:|com/starrocks/common/Config.java|1|1|100.00%|[]|




author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-10T07:27:07Z
body: #### [BE Incremental Coverage Report]


:white_check_mark: **pass** : 0 / 0 (0%)




author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-10T08:55:27Z
body: @Mergifyio backport branch-3.4
author_association: CONTRIBUTOR
user: login: mergify[bot]
created_at: 2025-03-10T08:55:41Z
body: > backport branch-3.4

#### ✅ Backports have been created

<details>

* [#56771 [Doc]rename configuartion to take charge of all query-trigger tasks (backport #56544)](https://github.com/StarRocks/starrocks/pull/56771) has been created for branch `branch-3.4` but encountered conflicts

</details>


<!---
DO NOT EDIT
-*- Mergify Payload -*-
{"command": "backport branch-3.4", "conclusion": "success", "action_is_running": true}
-*- Mergify Payload End -*-
-->
author_association: CONTRIBUTOR