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 fd66cc5befd (cooldown) explain cooldown_ttl for cooldown (#2842)
fd66cc5befd is described below
commit fd66cc5befdebbce484a8975b3a1a56893d68045
Author: Yongqiang YANG <[email protected]>
AuthorDate: Fri Sep 5 12:14:29 2025 +0800
(cooldown) explain cooldown_ttl for cooldown (#2842)
## Versions
- [x] dev
- [x] 3.0
- [x] 2.1
- [ ] 2.0
## Languages
- [ ] Chinese
- [ ] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
Co-authored-by: Yongqiang YANG <[email protected]>
---
docs/table-design/tiered-storage/remote-storage.md | 12 ++++++++++--
.../current/table-design/tiered-storage/remote-storage.md | 9 ++++++++-
.../table-design/tiered-storage/remote-storage.md | 6 ++++++
.../table-design/tiered-storage/remote-storage.md | 6 ++++++
.../table-design/tiered-storage/remote-storage.md | 14 +++++++++++---
.../table-design/tiered-storage/remote-storage.md | 14 +++++++++++---
6 files changed, 52 insertions(+), 9 deletions(-)
diff --git a/docs/table-design/tiered-storage/remote-storage.md
b/docs/table-design/tiered-storage/remote-storage.md
index 1f1bc62db65..c5c9f7ef299 100644
--- a/docs/table-design/tiered-storage/remote-storage.md
+++ b/docs/table-design/tiered-storage/remote-storage.md
@@ -152,9 +152,13 @@ For more details, please refer to the Docs directory under
[RESOURCE](../../sql-
- Tables using remote storage do not support backup.
-- Modifying the location information of remote storage, such as endpoint,
bucket, and path, is not supported.
+- Modifying the location information of remote storage, such as endpoint,
bucket, or path, is not supported.
-- Unique model tables do not support setting remote storage when the
Merge-on-Write feature is enabled.
+- Unique model tables with Merge-on-Write enabled do not support remote
storage.
+
+- Storage policies support creation, modification, and deletion. Before
deleting a storage policy, ensure that no tables are referencing it.
+
+- Once a storage policy is set, it cannot be unset.
## Cold Data Space
@@ -209,3 +213,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. What happens after modifying parameters related to cooldown time?
+
+ Changes to cooldown-related parameters only take effect for data that has
not yet been cooled to remote storage. For data that has already been cooled to
remote storage, the changes do not apply. For example, if you change
`cooldown_ttl` from 21 days to 7 days, data that is already in remote storage
will not be moved back to local storage;
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/tiered-storage/remote-storage.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/tiered-storage/remote-storage.md
index 6f8f8a6b2f4..27081fefc7b 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/tiered-storage/remote-storage.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/table-design/tiered-storage/remote-storage.md
@@ -138,7 +138,7 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
```
:::tip
-注意，如果用户在建表时给整张 Table 和部分 Partition 指定了不同的 Storage Policy，Partition 设置的 Storage
policy 会被无视，整张表的所有 Partition 都会使用 table 的 Policy. 如果您需要让某个 Partition 的 Policy
和别的不同，则可以使用上文中对一个已存在的 Partition，关联 Storage policy 的方式修改。
+注意，如果用户在建表时给整张 Table 和部分 Partition 指定了不同的 Storage Policy，Partition 设置的 Storage
policy 会被忽略，整张表的所有 Partition 都会使用 table 的 Policy. 如果您需要让某个 Partition 的 Policy
和别的不同，则可以使用上文中对一个已存在的 Partition，关联 Storage policy 的方式修改。
具体可以参考 Docs
目录下[RESOURCE](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-RESOURCE)、
[POLICY](../../sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-POLICY)、
[CREATE
TABLE](../../sql-manual/sql-statements/table-and-view/table/CREATE-TABLE)、
[ALTER
TABLE](../../sql-manual/sql-statements/table-and-view/table/ALTER-TABLE-COLUMN)等文档。
:::
@@ -159,6 +159,9 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
- Storage policy 支持创建、修改和删除，删除前需要先保证没有表引用此 Storage policy。
+- 一旦设置了 Storage policy 之后，不能取消设置。
+
+
## 冷数据空间
### 查看
@@ -212,3 +215,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. 修改冷却时间相关参数之后的行为表现是怎么样的？
+
+ 冷却时间相关的参数修改之后只对还未冷却到远程存储的数据生效，对于已经冷却到远程存储的数据不生效。比如将 `cooldown_ttl` 从 21
天修改为 7天，已经在远程存储的数据不会回到本地；
\ No newline at end of file
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/tiered-storage/remote-storage.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/tiered-storage/remote-storage.md
index 6f8f8a6b2f4..726dbc91a43 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/tiered-storage/remote-storage.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/table-design/tiered-storage/remote-storage.md
@@ -159,6 +159,8 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
- Storage policy 支持创建、修改和删除，删除前需要先保证没有表引用此 Storage policy。
+- 一旦设置了 Storage policy 之后，不能取消设置。
+
## 冷数据空间
### 查看
@@ -212,3 +214,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. 修改冷却时间相关参数之后的行为表现是怎么样的？
+
+冷却时间相关的参数修改之后只对还未冷却到远程存储的数据生效，对于已经冷却到远程存储的数据不生效。比如将 `cooldown_ttl` 从 21 天修改为
7天，已经在远程存储的数据不会回到本地；
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/table-design/tiered-storage/remote-storage.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/table-design/tiered-storage/remote-storage.md
index 6f8f8a6b2f4..726dbc91a43 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/table-design/tiered-storage/remote-storage.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/table-design/tiered-storage/remote-storage.md
@@ -159,6 +159,8 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
- Storage policy 支持创建、修改和删除，删除前需要先保证没有表引用此 Storage policy。
+- 一旦设置了 Storage policy 之后，不能取消设置。
+
## 冷数据空间
### 查看
@@ -212,3 +214,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. 修改冷却时间相关参数之后的行为表现是怎么样的？
+
+冷却时间相关的参数修改之后只对还未冷却到远程存储的数据生效，对于已经冷却到远程存储的数据不生效。比如将 `cooldown_ttl` 从 21 天修改为
7天，已经在远程存储的数据不会回到本地；
diff --git
a/versioned_docs/version-2.1/table-design/tiered-storage/remote-storage.md
b/versioned_docs/version-2.1/table-design/tiered-storage/remote-storage.md
index 8f7a9a32ed0..bce03768556 100644
--- a/versioned_docs/version-2.1/table-design/tiered-storage/remote-storage.md
+++ b/versioned_docs/version-2.1/table-design/tiered-storage/remote-storage.md
@@ -140,7 +140,7 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
:::tip
Note that if the user specifies different Storage Policies for the entire
Table and some Partitions when creating the table, the Storage Policy set for
the Partition will be ignored, and all Partitions of the table will use the
table's Policy. If you need a Partition's Policy to differ from others, you can
modify it using the method described above for associating a Storage Policy
with an existing Partition.
-For more details, please refer to the Docs directory under
[RESOURCE](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-RESOURCE),
[POLICY](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-WORKLOAD-POLICY),
[CREATE
TABLE](../../sql-manual/sql-statements/table-and-view/table/CREATE-TABLE),
[ALTER
TABLE](../../sql-manual/sql-statements/table-and-view/table/ALTER-TABLE-COLUMN),
etc.
+For more details, please refer to the Docs directory under
[RESOURCE](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-RESOURCE),
[STORAGE
POLICY](../../sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-POLICY),
[CREATE
TABLE](../../sql-manual/sql-statements/table-and-view/table/CREATE-TABLE),
[ALTER
TABLE](../../sql-manual/sql-statements/table-and-view/table/ALTER-TABLE-COLUMN),
etc.
:::
### Configuring Compaction
@@ -153,9 +153,13 @@ For more details, please refer to the Docs directory under
[RESOURCE](../../sql-
- Tables using remote storage do not support backup.
-- Modifying the location information of remote storage, such as endpoint,
bucket, and path, is not supported.
+- Modifying the location information of remote storage, such as endpoint,
bucket, or path, is not supported.
-- Unique model tables do not support setting remote storage when the
Merge-on-Write feature is enabled.
+- Unique model tables with Merge-on-Write enabled do not support remote
storage.
+
+- Storage policies support creation, modification, and deletion. Before
deleting a storage policy, ensure that no tables are referencing it.
+
+- Once a storage policy is set, it cannot be unset.
## Cold Data Space
@@ -210,3 +214,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. What happens after modifying parameters related to cooldown time?
+
+ Changes to cooldown-related parameters only take effect for data that has
not yet been cooled to remote storage. For data that has already been cooled to
remote storage, the changes do not apply. For example, if you change
`cooldown_ttl` from 21 days to 7 days, data that is already in remote storage
will not be moved back to local storage;
diff --git
a/versioned_docs/version-3.0/table-design/tiered-storage/remote-storage.md
b/versioned_docs/version-3.0/table-design/tiered-storage/remote-storage.md
index 8f7a9a32ed0..d9d1e55a3f3 100644
--- a/versioned_docs/version-3.0/table-design/tiered-storage/remote-storage.md
+++ b/versioned_docs/version-3.0/table-design/tiered-storage/remote-storage.md
@@ -140,7 +140,7 @@ ALTER TABLE create_table_partition MODIFY PARTITION (*)
SET("storage_policy"="te
:::tip
Note that if the user specifies different Storage Policies for the entire
Table and some Partitions when creating the table, the Storage Policy set for
the Partition will be ignored, and all Partitions of the table will use the
table's Policy. If you need a Partition's Policy to differ from others, you can
modify it using the method described above for associating a Storage Policy
with an existing Partition.
-For more details, please refer to the Docs directory under
[RESOURCE](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-RESOURCE),
[POLICY](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-WORKLOAD-POLICY),
[CREATE
TABLE](../../sql-manual/sql-statements/table-and-view/table/CREATE-TABLE),
[ALTER
TABLE](../../sql-manual/sql-statements/table-and-view/table/ALTER-TABLE-COLUMN),
etc.
+For more details, please refer to the Docs directory under
[RESOURCE](../../sql-manual/sql-statements/cluster-management/compute-management/CREATE-RESOURCE),
[STORAGE
POLICY](../../sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-POLICY),
[CREATE
TABLE](../../sql-manual/sql-statements/table-and-view/table/CREATE-TABLE),
[ALTER
TABLE](../../sql-manual/sql-statements/table-and-view/table/ALTER-TABLE-COLUMN),
etc.
:::
### Configuring Compaction
@@ -153,9 +153,13 @@ For more details, please refer to the Docs directory under
[RESOURCE](../../sql-
- Tables using remote storage do not support backup.
-- Modifying the location information of remote storage, such as endpoint,
bucket, and path, is not supported.
+- Modifying the location information of remote storage, such as endpoint,
bucket, or path, is not supported.
-- Unique model tables do not support setting remote storage when the
Merge-on-Write feature is enabled.
+- Unique model tables with Merge-on-Write enabled do not support remote
storage.
+
+- Storage policies support creation, modification, and deletion. Before
deleting a storage policy, ensure that no tables are referencing it.
+
+- Once a storage policy is set, it cannot be unset.
## Cold Data Space
@@ -210,3 +214,7 @@ PROPERTIES
"use_path_style" = "true"
);
```
+
+2. What happens after modifying parameters related to cooldown time?
+
+ Changes to cooldown-related parameters only take effect for data that has
not yet been cooled to remote storage. For data that has already been cooled to
remote storage, the changes do not apply. For example, if you change
`cooldown_ttl` from 21 days to 7 days, data that is already in remote storage
will not be moved back to local storage;
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
