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 3d9e4b467f8 Feature backup colocate (#3384)
3d9e4b467f8 is described below
commit 3d9e4b467f8006fb50ead79dd03727c53b10190b
Author: Yongqiang YANG <[email protected]>
AuthorDate: Tue Feb 10 17:55:49 2026 -0800
Feature backup colocate (#3384)
## Summary
- Recreate the `reserve_colocate` restore-property documentation update
from #1810.
- Add `reserve_colocate` under RESTORE properties for `dev` and `4.x`.
- Apply this to both English and Chinese docs.
## Versions
- [x] dev
- [x] 4.x
- [ ] 3.x
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Reference
- Original PR: https://github.com/apache/doris-website/pull/1810
Co-authored-by: zhangyuan <[email protected]>
---
.../sql-statements/data-modification/backup-and-restore/RESTORE.md | 1 +
.../sql-statements/data-modification/backup-and-restore/RESTORE.md | 1 +
.../sql-statements/data-modification/backup-and-restore/RESTORE.md | 1 +
.../sql-statements/data-modification/backup-and-restore/RESTORE.md | 1 +
4 files changed, 4 insertions(+)
diff --git
a/docs/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
b/docs/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
index 1be51285169..aa9de69a677 100644
---
a/docs/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
+++
b/docs/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
@@ -43,6 +43,7 @@ Restoration operation attributes, the format is `<key>` =
`<value>`，currently
- "backup_timestamp" = "2018-05-04-16-45-08": Specifies which time version of
the corresponding backup to restore, required. This information can be obtained
with the `SHOW SNAPSHOT ON repo;` statement.
- "replication_num" = "3": Specifies the number of replicas for the restored
table or partition. Default is 3. If restoring an existing table or partition,
the number of replicas must be the same as the number of replicas of the
existing table or partition. At the same time, there must be enough hosts to
accommodate multiple replicas.
- "reserve_replica" = "true": Default is false. When this property is true,
the replication_num property is ignored and the restored table or partition
will have the same number of replication as before the backup. Supports
multiple tables or multiple partitions within a table with different
replication number.
+- "reserve_colocate" = "true": Default is false. When this property is false,
the colocate property is not restored. When this property is true, the restored
table keeps the colocate property.
- "reserve_dynamic_partition_enable" = "true": Default is false. When this
property is true, the restored table will have the same value of
'dynamic_partition_enable' as before the backup. if this property is not true,
the restored table will set 'dynamic_partition_enable=false'.
- "timeout" = "3600": The task timeout period, the default is one day. in
seconds.
- "meta_version" = 40: Use the specified meta_version to read the previously
backed up metadata. Note that this parameter is used as a temporary solution
and is only used to restore the data backed up by the old version of Doris. The
latest version of the backup data already contains the meta version, no need to
specify it.
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
index a2f04722e6f..ec0d777d29e 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
@@ -43,6 +43,7 @@ FROM `<repository_name>`
- "backup_timestamp" = "2018-05-04-16-45-08"：指定了恢复对应备份的哪个时间版本，必填。该信息可以通过 `SHOW
SNAPSHOT ON repo;` 语句获得。
- "replication_num" = "3"：指定恢复的表或分区的副本数。默认为
3。若恢复已存在的表或分区，则副本数必须和已存在表或分区的副本数相同。同时，必须有足够的 host 容纳多个副本。
- "reserve_replica" = "true"：默认为 false。当该属性为 true 时，会忽略 replication_num
属性，恢复的表或分区的副本数将与备份之前一样。支持多个表或表内多个分区有不同的副本数。
+- "reserve_colocate" = "true"：默认为 false。该属性为 true 时，恢复的表会保留 colocate 属性；为
false 时不保留。
- "reserve_dynamic_partition_enable" = "true"：默认为 false。当该属性为 true
时，恢复的表会保留该表备份之前的'dynamic_partition_enable'属性值。该值不为 true
时，则恢复出来的表的'dynamic_partition_enable'属性值会设置为 false。
- "timeout" = "3600"：任务超时时间，默认为一天。单位秒。
- "meta_version" = 40：使用指定的 meta_version 来读取之前备份的元数据。注意，该参数作为临时方案，仅用于恢复老版本
Doris 备份的数据。最新版本的备份数据中已经包含 meta version，无需再指定。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
index a2f04722e6f..ec0d777d29e 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
@@ -43,6 +43,7 @@ FROM `<repository_name>`
- "backup_timestamp" = "2018-05-04-16-45-08"：指定了恢复对应备份的哪个时间版本，必填。该信息可以通过 `SHOW
SNAPSHOT ON repo;` 语句获得。
- "replication_num" = "3"：指定恢复的表或分区的副本数。默认为
3。若恢复已存在的表或分区，则副本数必须和已存在表或分区的副本数相同。同时，必须有足够的 host 容纳多个副本。
- "reserve_replica" = "true"：默认为 false。当该属性为 true 时，会忽略 replication_num
属性，恢复的表或分区的副本数将与备份之前一样。支持多个表或表内多个分区有不同的副本数。
+- "reserve_colocate" = "true"：默认为 false。该属性为 true 时，恢复的表会保留 colocate 属性；为
false 时不保留。
- "reserve_dynamic_partition_enable" = "true"：默认为 false。当该属性为 true
时，恢复的表会保留该表备份之前的'dynamic_partition_enable'属性值。该值不为 true
时，则恢复出来的表的'dynamic_partition_enable'属性值会设置为 false。
- "timeout" = "3600"：任务超时时间，默认为一天。单位秒。
- "meta_version" = 40：使用指定的 meta_version 来读取之前备份的元数据。注意，该参数作为临时方案，仅用于恢复老版本
Doris 备份的数据。最新版本的备份数据中已经包含 meta version，无需再指定。
diff --git
a/versioned_docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
b/versioned_docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
index 1be51285169..aa9de69a677 100644
---
a/versioned_docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
+++
b/versioned_docs/version-4.x/sql-manual/sql-statements/data-modification/backup-and-restore/RESTORE.md
@@ -43,6 +43,7 @@ Restoration operation attributes, the format is `<key>` =
`<value>`，currently
- "backup_timestamp" = "2018-05-04-16-45-08": Specifies which time version of
the corresponding backup to restore, required. This information can be obtained
with the `SHOW SNAPSHOT ON repo;` statement.
- "replication_num" = "3": Specifies the number of replicas for the restored
table or partition. Default is 3. If restoring an existing table or partition,
the number of replicas must be the same as the number of replicas of the
existing table or partition. At the same time, there must be enough hosts to
accommodate multiple replicas.
- "reserve_replica" = "true": Default is false. When this property is true,
the replication_num property is ignored and the restored table or partition
will have the same number of replication as before the backup. Supports
multiple tables or multiple partitions within a table with different
replication number.
+- "reserve_colocate" = "true": Default is false. When this property is false,
the colocate property is not restored. When this property is true, the restored
table keeps the colocate property.
- "reserve_dynamic_partition_enable" = "true": Default is false. When this
property is true, the restored table will have the same value of
'dynamic_partition_enable' as before the backup. if this property is not true,
the restored table will set 'dynamic_partition_enable=false'.
- "timeout" = "3600": The task timeout period, the default is one day. in
seconds.
- "meta_version" = 40: Use the specified meta_version to read the previously
backed up metadata. Note that this parameter is used as a temporary solution
and is only used to restore the data backed up by the old version of Doris. The
latest version of the backup data already contains the meta version, no need to
specify it.
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
