From e1bc7a9f9df014bb6c7ceedcbe83caf1c1e039ed Mon Sep 17 00:00:00 2001 From: bobhan1 Date: Sat, 28 Feb 2026 18:29:57 +0800 Subject: [PATCH] [fix] clarify partial column update parameters for different import methods Clarify that session variable `enable_unique_key_partial_update` controls INSERT INTO imports, while `partial_columns` parameter controls Stream Load and other import methods. This fixes the ambiguous description from PR #3248. Co-Authored-By: Claude Opus 4.6 --- 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 +- .../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 +- 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 f7a2e687888a4..38e65f0d05fd8 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 f47ff3abd9ae4..5ccb37e7119bd 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 110acca7acd99..06b43cb3eedc4 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 f995003ad3adb..5ccb37e7119bd 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 f995003ad3adb..5ccb37e7119bd 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 862bf398fe3b1..85db3cd55b3e1 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 f7a2e687888a4..38e65f0d05fd8 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 f7a2e687888a4..38e65f0d05fd8 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 (