This is an automated email from the ASF dual-hosted git repository.
dataroaring 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 f33d206c950 [fix](conf) add config doc for cold data compaction (#3170)
f33d206c950 is described below
commit f33d206c950f9aa760139bfb2c6f7b16e510d5e0
Author: Yongqiang YANG <[email protected]>
AuthorDate: Mon Dec 8 18:59:27 2025 -0800
[fix](conf) add config doc for cold data compaction (#3170)
## Versions
- [x] dev
- [x] 4.x
- [x] 3.x
- [ ] 2.1
## Languages
- [ ] Chinese
- [ ] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
Co-authored-by: Yongqiang YANG <[email protected]>
---
docs/admin-manual/config/be-config.md | 17 +++++++++++++++++
.../current/admin-manual/config/be-config.md | 18 ++++++++++++++++++
.../version-3.x/admin-manual/config/be-config.md | 18 ++++++++++++++++++
.../version-4.x/admin-manual/config/be-config.md | 6 ++++++
.../version-3.x/admin-manual/config/be-config.md | 18 ++++++++++++++++++
.../version-4.x/admin-manual/config/be-config.md | 19 +++++++++++++++++++
6 files changed, 96 insertions(+)
diff --git a/docs/admin-manual/config/be-config.md
b/docs/admin-manual/config/be-config.md
index cb3d588c559..dc94bb24faf 100644
--- a/docs/admin-manual/config/be-config.md
+++ b/docs/admin-manual/config/be-config.md
@@ -639,6 +639,23 @@ BaseCompaction:546859:
* Description: Minimal interval (s) to update peer replica infos
* Default value: 60 (s)
+#### `cold_data_compaction_score_threshold`
+
+* Type: int32
+* Description: This configuration specifies the minimum compaction score
threshold for cold data before triggering compaction. When the compaction score
of cold data exceeds this threshold, compaction will be considered. Adjusting
this value helps control the frequency and aggressiveness of compaction on cold
data in remote storage. Supported since 3.1.3.
+* Default value: 100
+
+#### `cold_data_compaction_thread_num`
+
+* Type: int32
+* Description: The number of threads used for cold data compaction. This
configuration controls the degree of parallelism for cold data compaction
tasks. Increasing this value allows more compaction tasks on cold data to run
simultaneously, which may improve throughput but also increase resource usage.
+* Default value: 2
+
+#### `cold_data_compaction_interval_sec`
+
+* Type: int32
+* Description: The time interval in seconds between triggers for cold data
compaction. A shorter interval means compaction on cold data will be considered
more frequently, potentially leading to faster cleanup but higher resource
consumption.
+* Default value: 1800 (seconds)
### Load
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/be-config.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/be-config.md
index b5061831ff1..a8f5396bdde 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/be-config.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/be-config.md
@@ -647,9 +647,27 @@ BaseCompaction:546859:
#### `update_replica_infos_interval_seconds`
+* 类型：int32
* 描述：更新 peer replica infos 的最小间隔时间
* 默认值：60（s）
+#### `cold_data_compaction_score_threshold`
+
+* 类型：int32
+* 描述：该配置项指定触发冷数据 compaction 的最小 compaction 分数阈值。当冷数据的 compaction 分数超过该阈值时，会触发
compaction。调整该值有助于控制远程存储（如冷数据）上的 compaction 频率和激进程度。自 3.1.3 版本起支持。
+* 默认值：100
+
+#### `cold_data_compaction_thread_num`
+
+* 类型：int32
+* 描述：用于冷数据 compaction 的线程数。该配置项控制冷数据 compaction 任务的并发度，数值越大，同时进行的冷数据
compaction 任务越多，可以提升吞吐能力，但也会增加资源消耗。
+* 默认值：2
+
+#### `cold_data_compaction_interval_sec`
+
+* 类型：int32
+* 描述：触发冷数据 compaction 的时间间隔，单位为秒。间隔越短，冷数据 compaction
检查越频繁，有助于更快地清理冷数据，但也会消耗更多资源。
+* 默认值：1800（秒）
### 导入
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/config/be-config.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/config/be-config.md
index 7c64cb159b3..cfdfaab76f1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/config/be-config.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/config/be-config.md
@@ -666,9 +666,27 @@ BaseCompaction:546859:
#### `update_replica_infos_interval_seconds`
+* 类型：int32
* 描述：更新 peer replica infos 的最小间隔时间
* 默认值：60（s）
+#### `cold_data_compaction_score_threshold`
+
+* 类型：int32
+* 描述：该配置项指定触发冷数据 compaction 的最小 compaction 分数阈值。当冷数据的 compaction 分数超过该阈值时，会触发
compaction。调整该值有助于控制远程存储（如冷数据）上的 compaction 频率和激进程度。自 3.1.3 版本起支持。
+* 默认值：100
+
+#### `cold_data_compaction_thread_num`
+
+* 类型：int32
+* 描述：用于冷数据 compaction 的线程数。该配置项控制冷数据 compaction 任务的并发度，数值越大，同时进行的冷数据
compaction 任务越多，可以提升吞吐能力，但也会增加资源消耗。
+* 默认值：2
+
+#### `cold_data_compaction_interval_sec`
+
+* 类型：int32
+* 描述：触发冷数据 compaction 的时间间隔，单位为秒。间隔越短，冷数据 compaction
检查越频繁，有助于更快地清理冷数据，但也会消耗更多资源。
+* 默认值：1800（秒）
### 导入
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
index b5061831ff1..92e16563105 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/be-config.md
@@ -647,9 +647,15 @@ BaseCompaction:546859:
#### `update_replica_infos_interval_seconds`
+* 类型：int32
* 描述：更新 peer replica infos 的最小间隔时间
* 默认值：60（s）
+#### `cold_data_compaction_score_threshold`
+
+* 类型：int32
+* 描述：该配置项指定触发冷数据 compaction 的最小 compaction 分数阈值。当冷数据的 compaction 分数超过该阈值时，会触发
compaction。调整该值有助于控制远程存储（如冷数据）上的 compaction 频率和激进程度。自 3.1.3 版本起支持。
+* 默认值：100
### 导入
diff --git a/versioned_docs/version-3.x/admin-manual/config/be-config.md
b/versioned_docs/version-3.x/admin-manual/config/be-config.md
index 56f5184b974..9b999b0beb8 100644
--- a/versioned_docs/version-3.x/admin-manual/config/be-config.md
+++ b/versioned_docs/version-3.x/admin-manual/config/be-config.md
@@ -638,9 +638,27 @@ BaseCompaction:546859:
#### `update_replica_infos_interval_seconds`
+* Type: int32
* Description: Minimal interval (s) to update peer replica infos
* Default value: 60 (s)
+#### `cold_data_compaction_score_threshold`
+
+* Type: int32
+* Description: This configuration specifies the minimum compaction score
threshold for cold data before triggering compaction. When the compaction score
of cold data exceeds this threshold, compaction will be considered. Adjusting
this value helps control the frequency and aggressiveness of compaction on cold
data in remote storage. Supported since 3.1.3.
+* Default value: 100
+
+#### `cold_data_compaction_thread_num`
+
+* Type: int32
+* Description: The number of threads used for cold data compaction. This
configuration controls the degree of parallelism for cold data compaction
tasks. Increasing this value allows more compaction tasks on cold data to run
simultaneously, which may improve throughput but also increase resource usage.
+* Default value: 2
+
+#### `cold_data_compaction_interval_sec`
+
+* Type: int32
+* Description: The time interval in seconds between triggers for cold data
compaction. A shorter interval means compaction on cold data will be considered
more frequently, potentially leading to faster cleanup but higher resource
consumption.
+* Default value: 1800 (seconds)
### Load
diff --git a/versioned_docs/version-4.x/admin-manual/config/be-config.md
b/versioned_docs/version-4.x/admin-manual/config/be-config.md
index cb3d588c559..b2050f79ea6 100644
--- a/versioned_docs/version-4.x/admin-manual/config/be-config.md
+++ b/versioned_docs/version-4.x/admin-manual/config/be-config.md
@@ -636,9 +636,28 @@ BaseCompaction:546859:
#### `update_replica_infos_interval_seconds`
+* Type: int32
* Description: Minimal interval (s) to update peer replica infos
* Default value: 60 (s)
+#### `cold_data_compaction_score_threshold`
+
+* Type: int32
+* Description: This configuration specifies the minimum compaction score
threshold for cold data before triggering compaction. When the compaction score
of cold data exceeds this threshold, compaction will be considered. Adjusting
this value helps control the frequency and aggressiveness of compaction on cold
data in remote storage. Supported since 3.1.3.
+* Default value: 100
+
+#### `cold_data_compaction_thread_num`
+
+* Type: int32
+* Description: The number of threads used for cold data compaction. This
configuration controls the degree of parallelism for cold data compaction
tasks. Increasing this value allows more compaction tasks on cold data to run
simultaneously, which may improve throughput but also increase resource usage.
+* Default value: 2
+
+#### `cold_data_compaction_interval_sec`
+
+* Type: int32
+* Description: The time interval in seconds between triggers for cold data
compaction. A shorter interval means compaction on cold data will be considered
more frequently, potentially leading to faster cleanup but higher resource
consumption.
+* Default value: 1800 (seconds)
+
### Load
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
