This is an automated email from the ASF dual-hosted git repository.
morningman 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 dc394b46963 [feat](meta-cache) add schema cache doc (#2389)
dc394b46963 is described below
commit dc394b46963ebdb09db18dbf4e7fe2b5e9a8c35e
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Mon May 19 16:17:27 2025 +0800
[feat](meta-cache) add schema cache doc (#2389)
## Versions
- [x] dev
- [ ] 3.0
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
docs/lakehouse/meta-cache.md | 44 +++++++++++++++++-----
.../current/lakehouse/meta-cache.md | 43 +++++++++++++++++----
2 files changed, 70 insertions(+), 17 deletions(-)
diff --git a/docs/lakehouse/meta-cache.md b/docs/lakehouse/meta-cache.md
index c1087a77180..70861826f23 100644
--- a/docs/lakehouse/meta-cache.md
+++ b/docs/lakehouse/meta-cache.md
@@ -309,19 +309,45 @@ This section mainly introduces the cache behavior that
users may be concerned ab
- New partitions added to the external data source need to be manually
refreshed or waited for up to 10 minutes to query the new partition data.
- Changes in partition data files need to be manually refreshed or waited for
up to 10 minutes to query the new partition data.
+### Disable Schema Cache
+
+For all kinds of external catalogs, if you want to access the latest schema
immediately, you can disable the schema cache.
+
+- Disable globally
+
+ ```
+ -- fe.conf
+ max_external_schema_cache_num=0 // Disable schema cache globally
+ ```
+
+- Disable at catalog level
+
+ ```
+ -- Catalog property
+ "schema.cache.ttl-second" = "0" // Disable schema cache cache for a
specific Catalog(Since 2.1.11, 3.0.6)
+ ```
+
+After setting the above parameters, Doris will always see the latest schema of
tables, but it will increase the access pressure on external meta service.
+
### Disable Hive Catalog Metadata Cache
For the Hive Catalog, if you want to disable the cache to query real-time
updated data, you can configure the following parameters:
-```
--- fe.conf
-max_external_file_cache_num=0 // Disable file list cache
-max_hive_partition_table_cache_num=0 // Disable partition list cache
-
--- Catalog property
-"file.meta.cache.ttl-second" = "0" // Disable file list cache for a specific
Catalog
-"partition.cache.ttl-second" = "0" // Disable partition list cache for a
specific Catalog(Since 2.1.11, 3.0.6)
-```
+- Disable globally
+
+ ```
+ -- fe.conf
+ max_external_file_cache_num=0 // Disable file list cache
+ max_hive_partition_table_cache_num=0 // Disable partition list cache
+ ```
+
+- Disable at catalog level
+
+ ```
+ -- Catalog property
+ "file.meta.cache.ttl-second" = "0" // Disable file list cache for a
specific Catalog
+ "partition.cache.ttl-second" = "0" // Disable partition list cache for a
specific Catalog(Since 2.1.11, 3.0.6)
+ ```
After setting the above parameters:
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/meta-cache.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/meta-cache.md
index ac8cf7396f8..e3b73539262 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/meta-cache.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/meta-cache.md
@@ -309,19 +309,46 @@ CREATE CATALOG hive PROPERTIES (
- 外部数据源新增分区，需要手动刷新缓存，或最多等待 10 分钟后，可以查询到新分区的数据。
- 分区数据文件变动，需要手动刷新缓存，或最多等待 10 分钟后，可以查询到新分区的数据。
+### 关闭 Schema 缓存
+
+对于所有类型的 External Catalog，如果希望实时可见最新的 Table Schema，可以关闭 Schema Cache：
+
+- 全局关闭
+
+ ```
+ -- fe.conf
+ max_external_schema_cache_num=0 // 关闭 Schema 缓存。
+ ```
+
+- Catalog 级别关闭
+
+ ```
+ -- Catalog property
+ "schema.cache.ttl-second" = "0" // 针对某个 Catalog，关闭 Schema 缓存（2.1.11, 3.0.6
支持）
+ ```
+
+设置完成后，Doris 会实时可见最新的 Table Schema。但此设置可能会增加元数据服务的压力。
+
### 关闭 Hive Catalog 元数据缓存
针对 Hive Catalog，如果想关闭缓存来查询到实时更新的数据，可以配置以下参数：
-```
--- fe.conf
-max_external_file_cache_num=0 // 关闭文件列表缓存
-max_hive_partition_table_cache_num=0 // 关闭分区列表缓存
--- Catalog property
-"file.meta.cache.ttl-second" = "0" // 针对某个 Catalog，关闭文件列表缓存
-"partition.cache.ttl-second" = "0" // 针对某个 Catalog，关闭分区列表缓存（2.1.11, 3.0.6 支持）
-```
+- 全局关闭
+
+ ```
+ -- fe.conf
+ max_external_file_cache_num=0 // 关闭文件列表缓存
+ max_hive_partition_table_cache_num=0 // 关闭分区列表缓存
+ ```
+
+- Catalog 级别关闭
+
+ ```
+ -- Catalog property
+ "file.meta.cache.ttl-second" = "0" // 针对某个 Catalog，关闭文件列表缓存
+ "partition.cache.ttl-second" = "0" // 针对某个 Catalog，关闭分区列表缓存（2.1.11, 3.0.6
支持）
+ ```
设置以上参数后：
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
