This is an automated email from the ASF dual-hosted git repository.
luzhijing 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 50834fa98c [enhancement](doc) add more details about auto partition
cross-feature implementation (#681)
50834fa98c is described below
commit 50834fa98c0a6fee9a6a615ed8023b20a8ff3e19
Author: zclllyybb <[email protected]>
AuthorDate: Wed Jun 5 10:26:24 2024 +0800
[enhancement](doc) add more details about auto partition cross-feature
implementation (#681)
---
docs/table-design/schema-change.md | 2 +-
.../current/table-design/data-partition.md | 5 +++--
.../current/table-design/schema-change.md | 2 +-
.../version-2.1/table-design/data-partition.md | 5 +++--
.../version-2.1/table-design/schema-change.md | 2 +-
versioned_docs/version-2.1/table-design/schema-change.md | 2 +-
6 files changed, 10 insertions(+), 8 deletions(-)
diff --git a/docs/table-design/schema-change.md
b/docs/table-design/schema-change.md
index 582a293240..608b2a5bbc 100644
--- a/docs/table-design/schema-change.md
+++ b/docs/table-design/schema-change.md
@@ -416,7 +416,7 @@ CANCEL ALTER TABLE COLUMN FROM tbl_name;
- Only one schema change job can run on a table at a time.
-- Schema change operations do not block import and query operations.
+- Schema change operations do not block import and query operations. Unless
the operation affects the table's metadata (e.g., a partition is created during
an auto partition table's import)
- Partition and bucket columns cannot be modified.
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/data-partition.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/data-partition.md
index fff13f0563..93f6c72754 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/data-partition.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/data-partition.md
@@ -1071,12 +1071,13 @@ mysql> show partitions from `DAILY_TRADE_VALUE`;
### 注意事项
-- 如同普通分区表一样，AUTO PARTITION 支持多列分区，语法并无区别。
+- 如同普通分区表一样，AUTO LIST PARTITION 支持多列分区，语法并无区别。
- 在数据的插入或导入过程中如果创建了分区，而整个导入过程没有完成（失败或被取消），被创建的分区不会被自动删除。
- 使用 AUTO PARTITION 的表，只是分区创建方式上由手动转为了自动。表及其所创建分区的原本使用方法都与非 AUTO PARTITION
的表或分区相同。
- 为防止意外创建过多分区，我们通过[FE
配置项](../admin-manual/config/fe-config)中的`max_auto_partition_num`控制了一个 AUTO
PARTITION 表最大容纳分区数。如有需要可以调整该值
-- 向开启了 AUTO PARTITION 的表导入数据时，Coordinator 发送数据的轮询间隔与普通表有所不同。具体请见[BE
配置项](../admin-manual/config/be-config)中的`olap_table_sink_send_interval_auto_partition_factor`。
+- 向开启了 AUTO PARTITION 的表导入数据时，Coordinator 发送数据的轮询间隔与普通表有所不同。具体请见[BE
配置项](../admin-manual/config/be-config)中的`olap_table_sink_send_interval_auto_partition_factor`。开启前移（`enable_memtable_on_sink_node
= true`）后该变量不产生影响。
-
在使用[insert-overwrite](../sql-manual/sql-statements/Data-Manipulation-Statements/Manipulation/INSERT-OVERWRITE)插入数据时，如果指定了覆写的
partition，则 AUTO PARTITION 表在此过程中表现得如同普通表，不创建新的分区。
+- 如果导入创建分区时，该表涉及其他元数据操作（如 Schema Change、Rebalance），则导入可能失败。
## 手动分桶
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/schema-change.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/schema-change.md
index fdefbda736..f3fb6fda4e 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/schema-change.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/schema-change.md
@@ -416,7 +416,7 @@ CANCEL ALTER TABLE COLUMN FROM tbl_name;
- 一张表在同一时间只能有一个 Schema Change 作业在运行。
-- Schema Change 操作不阻塞导入和查询操作。
+- Schema Change 操作不阻塞导入和查询操作。除非操作本身影响了表的元数据（例如自动分区表导入过程中创建了分区）
- 分区列和分桶列不能修改。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/data-partition.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/data-partition.md
index 1314411c3e..d20dcaa8d7 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/data-partition.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/data-partition.md
@@ -1073,12 +1073,13 @@ mysql> show partitions from `DAILY_TRADE_VALUE`;
### 注意事项
-- 如同普通分区表一样，AUTO PARTITION 支持多列分区，语法并无区别。
+- 如同普通分区表一样，AUTO LIST PARTITION 支持多列分区，语法并无区别。
- 在数据的插入或导入过程中如果创建了分区，而整个导入过程没有完成（失败或被取消），被创建的分区不会被自动删除。
- 使用 AUTO PARTITION 的表，只是分区创建方式上由手动转为了自动。表及其所创建分区的原本使用方法都与非 AUTO PARTITION
的表或分区相同。
- 为防止意外创建过多分区，我们通过[FE
配置项](../admin-manual/config/fe-config)中的`max_auto_partition_num`控制了一个 AUTO
PARTITION 表最大容纳分区数。如有需要可以调整该值
-- 向开启了 AUTO PARTITION 的表导入数据时，Coordinator 发送数据的轮询间隔与普通表有所不同。具体请见[BE
配置项](../admin-manual/config/be-config)中的`olap_table_sink_send_interval_auto_partition_factor`。
+- 向开启了 AUTO PARTITION 的表导入数据时，Coordinator 发送数据的轮询间隔与普通表有所不同。具体请见[BE
配置项](../admin-manual/config/be-config)中的`olap_table_sink_send_interval_auto_partition_factor`。开启前移（`enable_memtable_on_sink_node
= true`）后该变量不产生影响。
-
在使用[insert-overwrite](../sql-manual/sql-statements/Data-Manipulation-Statements/Manipulation/INSERT-OVERWRITE)插入数据时，如果指定了覆写的
partition，则 AUTO PARTITION 表在此过程中表现得如同普通表，不创建新的分区。
+- 如果导入创建分区时，该表涉及其他元数据操作（如 Schema Change、Rebalance），则导入可能失败。
## 手动分桶
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/schema-change.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/schema-change.md
index fdefbda736..f3fb6fda4e 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/schema-change.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/schema-change.md
@@ -416,7 +416,7 @@ CANCEL ALTER TABLE COLUMN FROM tbl_name;
- 一张表在同一时间只能有一个 Schema Change 作业在运行。
-- Schema Change 操作不阻塞导入和查询操作。
+- Schema Change 操作不阻塞导入和查询操作。除非操作本身影响了表的元数据（例如自动分区表导入过程中创建了分区）
- 分区列和分桶列不能修改。
diff --git a/versioned_docs/version-2.1/table-design/schema-change.md
b/versioned_docs/version-2.1/table-design/schema-change.md
index 582a293240..608b2a5bbc 100644
--- a/versioned_docs/version-2.1/table-design/schema-change.md
+++ b/versioned_docs/version-2.1/table-design/schema-change.md
@@ -416,7 +416,7 @@ CANCEL ALTER TABLE COLUMN FROM tbl_name;
- Only one schema change job can run on a table at a time.
-- Schema change operations do not block import and query operations.
+- Schema change operations do not block import and query operations. Unless
the operation affects the table's metadata (e.g., a partition is created during
an auto partition table's import)
- Partition and bucket columns cannot be modified.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
