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 e76bb7eb5f7 [fix] clarify partial column update params for different
import methods (#3423)
e76bb7eb5f7 is described below
commit e76bb7eb5f75a0e63a3256685eefa912f8a9353c
Author: bobhan1 <[email protected]>
AuthorDate: Mon Mar 2 09:40:25 2026 +0800
[fix] clarify partial column update params for different import methods
(#3423)
## Summary
- Clarify that session variable `enable_unique_key_partial_update`
controls **INSERT INTO** imports
- Clarify that `partial_columns` parameter controls **Stream Load** and
other import methods
- Fixes the ambiguous description introduced in #3248, which did not
distinguish which parameter controls which import method
## Changes
Updated the partial column update description in `update-overview.md`
across all 8 files (EN/ZH, all versions: latest, 2.1, 3.x, 4.x).
## Test plan
- [ ] Verify the documentation renders correctly on the website
- [ ] Confirm the description accurately reflects Doris behavior
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-authored-by: Claude Opus 4.6 <[email protected]>
---
docs/data-operate/update/update-overview.md | 2 +-
.../current/data-operate/update/update-overview.md | 2 +-
.../version-2.1/data-operate/update/update-overview.md | 2 +-
.../version-3.x/data-operate/update/update-overview.md | 2 +-
.../version-4.x/data-operate/update/update-overview.md | 2 +-
versioned_docs/version-2.1/data-operate/update/update-overview.md | 2 +-
versioned_docs/version-3.x/data-operate/update/update-overview.md | 2 +-
versioned_docs/version-4.x/data-operate/update/update-overview.md | 2 +-
8 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/docs/data-operate/update/update-overview.md
b/docs/data-operate/update/update-overview.md
index f7a2e687888..38e65f0d05f 100644
--- a/docs/data-operate/update/update-overview.md
+++ b/docs/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ The following diagram shows how `DORIS_DELETE_SIGN` works:
Starting from version 2.0, Doris supports powerful partial column update
capabilities on Unique Key Models (MoW). When loading data, users only need to
provide the primary key and columns to be updated; unprovided columns will
maintain their original values unchanged. This greatly simplifies ETL processes
for scenarios like wide table joining and real-time tag updates.
-To enable this feature, you need to enable the write-time Merge (MoW) mode
when creating the unique key model table, and set the session variable
parameter 'enable_unique_key_partial_update' to 'true'. And configure the
'partial_columns' parameter during data loading.
+To enable this feature, you need to enable Merge-on-Write (MoW) mode when
creating the Unique Key Model table. For INSERT INTO, set the session variable
`enable_unique_key_partial_update` to `true` to enable partial column updates;
for Stream Load and other import methods, configure the `partial_columns`
parameter to enable partial column updates.
```sql
CREATE TABLE user_profiles (
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/update/update-overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/update/update-overview.md
index f47ff3abd9a..5ccb37e7119 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/update/update-overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ PROPERTIES (
从 2.0 版本开始，Doris
在主键模型（MoW）上支持了强大的部分列更新能力。用户在导入数据时，只需提供主键和待更新的列，未提供的列将保持其原值不变。这极大地简化了宽表拼接、实时标签更新等场景的ETL流程。
-要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式，并设置变量
`enable_unique_key_partial_update` 为 `true`。并且在数据导入时配置`"partial_columns"`参数。
+要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式。对于 INSERT INTO 导入，通过设置 session 变量
`enable_unique_key_partial_update` 为 `true` 来开启部分列更新；对于 Stream Load
等其他导入方式，通过配置 `partial_columns` 参数来开启部分列更新。
```sql
CREATE TABLE user_profiles (
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/update/update-overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/update/update-overview.md
index 110acca7acd..06b43cb3eed 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/update/update-overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ PROPERTIES (
从 2.0 版本开始，Doris
在主键模型（MoW）上支持了强大的部分列更新能力。用户在导入数据时，只需提供主键和待更新的列，未提供的列将保持其原值不变。这极大地简化了宽表拼接、实时标签更新等场景的ETL流程。
-要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式，并设置变量
`enable_unique_key_partial_update` 为 `true`，并且在数据导入时配置`"partial_columns"`参数。
+要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式。对于 INSERT INTO 导入，通过设置 session 变量
`enable_unique_key_partial_update` 为 `true` 来开启部分列更新；对于 Stream Load
等其他导入方式，通过配置 `partial_columns` 参数来开启部分列更新。
```sql
CREATE TABLE user_profiles (
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/update/update-overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/update/update-overview.md
index f995003ad3a..5ccb37e7119 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/update/update-overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ PROPERTIES (
从 2.0 版本开始，Doris
在主键模型（MoW）上支持了强大的部分列更新能力。用户在导入数据时，只需提供主键和待更新的列，未提供的列将保持其原值不变。这极大地简化了宽表拼接、实时标签更新等场景的ETL流程。
-要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式，并设置变量
`enable_unique_key_partial_update` 为 `true`，并且在数据导入时配置`"partial_columns"`参数。
+要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式。对于 INSERT INTO 导入，通过设置 session 变量
`enable_unique_key_partial_update` 为 `true` 来开启部分列更新；对于 Stream Load
等其他导入方式，通过配置 `partial_columns` 参数来开启部分列更新。
```sql
CREATE TABLE user_profiles (
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/update/update-overview.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/update/update-overview.md
index f995003ad3a..5ccb37e7119 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/update/update-overview.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ PROPERTIES (
从 2.0 版本开始，Doris
在主键模型（MoW）上支持了强大的部分列更新能力。用户在导入数据时，只需提供主键和待更新的列，未提供的列将保持其原值不变。这极大地简化了宽表拼接、实时标签更新等场景的ETL流程。
-要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式，并设置变量
`enable_unique_key_partial_update` 为 `true`，并且在数据导入时配置`"partial_columns"`参数。
+要启用此功能，需在创建主键模型表时，开启 Merge-on-Write (MoW) 模式。对于 INSERT INTO 导入，通过设置 session 变量
`enable_unique_key_partial_update` 为 `true` 来开启部分列更新；对于 Stream Load
等其他导入方式，通过配置 `partial_columns` 参数来开启部分列更新。
```sql
CREATE TABLE user_profiles (
diff --git a/versioned_docs/version-2.1/data-operate/update/update-overview.md
b/versioned_docs/version-2.1/data-operate/update/update-overview.md
index 862bf398fe3..85db3cd55b3 100644
--- a/versioned_docs/version-2.1/data-operate/update/update-overview.md
+++ b/versioned_docs/version-2.1/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ The following diagram shows how `DORIS_DELETE_SIGN` works:
Starting from version 2.0, Doris supports powerful partial column update
capabilities on Unique Key Models (MoW). When loading data, users only need to
provide the primary key and columns to be updated; unprovided columns will
maintain their original values unchanged. This greatly simplifies ETL processes
for scenarios like wide table joining and real-time tag updates.
-To enable this feature, you need to enable the write-time Merge (MoW) mode
when creating the unique key model table, and set the session variable
parameter 'enable_unique_key_partial_update' to 'true'. And configure the
'partial_columns' parameter during data loading.
+To enable this feature, you need to enable Merge-on-Write (MoW) mode when
creating the Unique Key Model table. For INSERT INTO, set the session variable
`enable_unique_key_partial_update` to `true` to enable partial column updates;
for Stream Load and other import methods, configure the `partial_columns`
parameter to enable partial column updates.
```sql
CREATE TABLE user_profiles (
diff --git a/versioned_docs/version-3.x/data-operate/update/update-overview.md
b/versioned_docs/version-3.x/data-operate/update/update-overview.md
index f7a2e687888..38e65f0d05f 100644
--- a/versioned_docs/version-3.x/data-operate/update/update-overview.md
+++ b/versioned_docs/version-3.x/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ The following diagram shows how `DORIS_DELETE_SIGN` works:
Starting from version 2.0, Doris supports powerful partial column update
capabilities on Unique Key Models (MoW). When loading data, users only need to
provide the primary key and columns to be updated; unprovided columns will
maintain their original values unchanged. This greatly simplifies ETL processes
for scenarios like wide table joining and real-time tag updates.
-To enable this feature, you need to enable the write-time Merge (MoW) mode
when creating the unique key model table, and set the session variable
parameter 'enable_unique_key_partial_update' to 'true'. And configure the
'partial_columns' parameter during data loading.
+To enable this feature, you need to enable Merge-on-Write (MoW) mode when
creating the Unique Key Model table. For INSERT INTO, set the session variable
`enable_unique_key_partial_update` to `true` to enable partial column updates;
for Stream Load and other import methods, configure the `partial_columns`
parameter to enable partial column updates.
```sql
CREATE TABLE user_profiles (
diff --git a/versioned_docs/version-4.x/data-operate/update/update-overview.md
b/versioned_docs/version-4.x/data-operate/update/update-overview.md
index f7a2e687888..38e65f0d05f 100644
--- a/versioned_docs/version-4.x/data-operate/update/update-overview.md
+++ b/versioned_docs/version-4.x/data-operate/update/update-overview.md
@@ -158,7 +158,7 @@ The following diagram shows how `DORIS_DELETE_SIGN` works:
Starting from version 2.0, Doris supports powerful partial column update
capabilities on Unique Key Models (MoW). When loading data, users only need to
provide the primary key and columns to be updated; unprovided columns will
maintain their original values unchanged. This greatly simplifies ETL processes
for scenarios like wide table joining and real-time tag updates.
-To enable this feature, you need to enable the write-time Merge (MoW) mode
when creating the unique key model table, and set the session variable
parameter 'enable_unique_key_partial_update' to 'true'. And configure the
'partial_columns' parameter during data loading.
+To enable this feature, you need to enable Merge-on-Write (MoW) mode when
creating the Unique Key Model table. For INSERT INTO, set the session variable
`enable_unique_key_partial_update` to `true` to enable partial column updates;
for Stream Load and other import methods, configure the `partial_columns`
parameter to enable partial column updates.
```sql
CREATE TABLE user_profiles (
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
