From 8b99f9832ee412cb1dc3b40fa3a704a33683dbd6 Mon Sep 17 00:00:00 2001 From: niuxianhui Date: Fri, 22 May 2026 20:23:43 -0700 Subject: [PATCH] [fix](doc) correct default_compression_type default value and valid values list MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The fe-config doc for `default_compression_type` had two factual errors: 1. Default value: doc said `lz4` (before 4.0.3) / `zstd` (since 4.0.3). The actual FE Config (apache/doris) is `LZ4F` (before 4.0.3) and `ZSTD` (4.0.3+). The default was changed by apache/doris#58923 (label dev/4.0.3-merged) — "change default compression from lz4f to zstd". LZ4 and LZ4F are different algorithms (raw block vs frame format), so `lz4` was simply wrong. 2. Valid values: doc said "lz4, zstd". The Config.java description and `PropertyAnalyzer.stringToCompressionType` accept seven algorithms: LZ4, LZ4F, LZ4HC, ZLIB, ZSTD, SNAPPY, NONE (case-insensitive). Update the doc to reflect the source-of-truth in apache/doris `fe/fe-common/.../common/Config.java` for both current/dev and 4.x, EN + zh. The parameter does not exist in branch-2.1 or branch-3.0, so no edit is needed in the 2.1 docs; the 3.x doc set is missing this parameter entirely, which is a separate gap. Closes #3463 --- docs/admin-manual/config/fe-config.md | 4 ++-- .../current/admin-manual/config/fe-config.md | 4 ++-- .../version-4.x/admin-manual/config/fe-config.md | 4 ++-- versioned_docs/version-4.x/admin-manual/config/fe-config.md | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/admin-manual/config/fe-config.md b/docs/admin-manual/config/fe-config.md index b9bd59857c349..dab50185367b6 100644 --- a/docs/admin-manual/config/fe-config.md +++ b/docs/admin-manual/config/fe-config.md @@ -2152,9 +2152,9 @@ When create a table(or partition), you can specify its storage medium(HDD or SSD #### `default_compression_type` -Default: lz4 (before 4.0.3), zstd (since 4.0.3) +Default: LZ4F (before 4.0.3), ZSTD (since 4.0.3) -When creating a table, you can specify its compression algorithm. If not set, this specifies the default compression type when creating a table. Valid values include: lz4, zstd. +When creating a table, you can specify its compression algorithm. If not set, this specifies the default compression type when creating a table. Valid values: LZ4, LZ4F, LZ4HC, ZLIB, ZSTD, SNAPPY, NONE (case-insensitive). #### `enable_storage_policy` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/fe-config.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/fe-config.md index 5469054af692b..9cc5612331b97 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/fe-config.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/config/fe-config.md @@ -2167,9 +2167,9 @@ tablet 状态更新间隔 #### `default_compression_type` -默认值：lz4（4.0.3 之前），zstd（4.0.3 及之后） +默认值：LZ4F（4.0.3 之前），ZSTD（4.0.3 及之后） -创建表时可以指定其压缩算法。如果未设置，则此配置项指定创建表时的默认压缩类型。有效值包括：lz4、zstd。 +创建表时可以指定其压缩算法。如果未设置，则此配置项指定创建表时的默认压缩类型。有效值：LZ4、LZ4F、LZ4HC、ZLIB、ZSTD、SNAPPY、NONE（大小写不敏感）。 #### `enable_storage_policy` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md index 5469054af692b..9cc5612331b97 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/config/fe-config.md @@ -2167,9 +2167,9 @@ tablet 状态更新间隔 #### `default_compression_type` -默认值：lz4（4.0.3 之前），zstd（4.0.3 及之后） +默认值：LZ4F（4.0.3 之前），ZSTD（4.0.3 及之后） -创建表时可以指定其压缩算法。如果未设置，则此配置项指定创建表时的默认压缩类型。有效值包括：lz4、zstd。 +创建表时可以指定其压缩算法。如果未设置，则此配置项指定创建表时的默认压缩类型。有效值：LZ4、LZ4F、LZ4HC、ZLIB、ZSTD、SNAPPY、NONE（大小写不敏感）。 #### `enable_storage_policy` diff --git a/versioned_docs/version-4.x/admin-manual/config/fe-config.md b/versioned_docs/version-4.x/admin-manual/config/fe-config.md index b9bd59857c349..dab50185367b6 100644 --- a/versioned_docs/version-4.x/admin-manual/config/fe-config.md +++ b/versioned_docs/version-4.x/admin-manual/config/fe-config.md @@ -2152,9 +2152,9 @@ When create a table(or partition), you can specify its storage medium(HDD or SSD #### `default_compression_type` -Default: lz4 (before 4.0.3), zstd (since 4.0.3) +Default: LZ4F (before 4.0.3), ZSTD (since 4.0.3) -When creating a table, you can specify its compression algorithm. If not set, this specifies the default compression type when creating a table. Valid values include: lz4, zstd. +When creating a table, you can specify its compression algorithm. If not set, this specifies the default compression type when creating a table. Valid values: LZ4, LZ4F, LZ4HC, ZLIB, ZSTD, SNAPPY, NONE (case-insensitive). #### `enable_storage_policy`