From 3283c7c8849b6b9a584e1e6544177f8a906773b0 Mon Sep 17 00:00:00 2001 From: Socrates Date: Fri, 24 Apr 2026 15:22:51 +0800 Subject: [PATCH 1/2] docs: update cache and paimon catalog notes --- .../file_cache_statistics.md | 2 ++ .../file_cache_statistics.md | 2 ++ .../file_cache_statistics.md | 2 ++ .../lakehouse/catalogs/paimon-catalog.mdx | 20 +++++++++++++++++++ .../file_cache_statistics.md | 2 ++ .../lakehouse/catalogs/paimon-catalog.mdx | 20 +++++++++++++++++++ .../file_cache_statistics.md | 2 ++ .../file_cache_statistics.md | 2 ++ .../lakehouse/catalogs/paimon-catalog.mdx | 20 +++++++++++++++++++ .../file_cache_statistics.md | 2 ++ .../lakehouse/catalogs/paimon-catalog.mdx | 20 +++++++++++++++++++ .../file_cache_statistics.md | 2 ++ 12 files changed, 96 insertions(+) diff --git a/docs/admin-manual/system-tables/information_schema/file_cache_statistics.md b/docs/admin-manual/system-tables/information_schema/file_cache_statistics.md index 7ba720aff3dc0..47a40446aeda5 100644 --- a/docs/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/docs/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -10,6 +10,8 @@ Used to view the metric information related to data cache on each BE node. The metric information is sourced from the monitoring metrics related to BE's data cache. +In compute-storage decoupled mode, this table only returns the BE nodes in the compute group used by the current query. If the cluster contains multiple compute groups, the query result may include only part of all BE nodes in the cluster. + :::tip Tip This system table is supported from versions 2.1.6 and 3.0.2. ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/system-tables/information_schema/file_cache_statistics.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/system-tables/information_schema/file_cache_statistics.md index a61cabf7d6857..aa7e56913d525 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -12,6 +12,8 @@ 指标信息来源于 BE 的数据缓存相关监控指标。 +在存算分离模式下，该系统表仅返回当前查询所使用的计算组（Compute Group）中的 BE 节点信息。如果集群中存在多个计算组，查询结果可能只包含集群全部 BE 节点中的一部分。 + :::tip 提示 该系统表自 2.1.6 和 3.0.2 版本支持。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md index 839043c40f80f..cee46b48bc314 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -12,6 +12,8 @@ 指标信息来源于 BE 的数据缓存相关监控指标。 +在存算分离模式下，该系统表仅返回当前查询所使用的计算组（Compute Group）中的 BE 节点信息。如果集群中存在多个计算组，查询结果可能只包含集群全部 BE 节点中的一部分。 + :::tip 提示 该系统表自 2.1.6 和 3.0.2 版本支持。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx index 8d6a834823bb3..30189c74252fb 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx @@ -340,6 +340,26 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES ( 'oss.secret_key' = '' ); ``` + + 对于 Doris 2.1 和 3.0 版本，如果 Paimon 表存储在阿里云 OSS-HDFS 中，且路径使用 `oss-dls.aliyuncs.com` 这类 OSS-HDFS Endpoint，需要显式添加 OSS-HDFS 和 Jindo FileSystem 相关属性： + + ```sql + CREATE CATALOG paimon_hms_on_oss_hdfs_catalog PROPERTIES ( + 'type' = 'paimon', + 'paimon.catalog.type' = 'hms', + 'warehouse' = 'oss://bucket.cn-beijing.oss-dls.aliyuncs.com/path/to/paimon_warehouse', + 'hive.metastore.uris' = 'thrift://127.0.0.1:9383', + 'fs.oss.accessKeyId' = '', + 'fs.oss.accessKeySecret' = '', + 'fs.oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.access_key' = '', + 'oss.secret_key' = '', + 'oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.hdfs.enabled' = 'true', + 'fs.oss.impl' = 'com.aliyun.jindodata.oss.JindoOssFileSystem', + 'fs.AbstractFileSystem.oss.impl' = 'com.aliyun.jindodata.oss.OSS' + ); + ``` ```sql diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md index 839043c40f80f..cee46b48bc314 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -12,6 +12,8 @@ 指标信息来源于 BE 的数据缓存相关监控指标。 +在存算分离模式下，该系统表仅返回当前查询所使用的计算组（Compute Group）中的 BE 节点信息。如果集群中存在多个计算组，查询结果可能只包含集群全部 BE 节点中的一部分。 + :::tip 提示 该系统表自 2.1.6 和 3.0.2 版本支持。 ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx index f160ca3a59c45..fd0570c92cdda 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx @@ -433,6 +433,26 @@ ORDER BY entry_name; 'oss.secret_key' = '' ); ``` + + 对于 Doris 2.1 和 3.0 版本，如果 Paimon 表存储在阿里云 OSS-HDFS 中，且路径使用 `oss-dls.aliyuncs.com` 这类 OSS-HDFS Endpoint，需要显式添加 OSS-HDFS 和 Jindo FileSystem 相关属性： + + ```sql + CREATE CATALOG paimon_hms_on_oss_hdfs_catalog PROPERTIES ( + 'type' = 'paimon', + 'paimon.catalog.type' = 'hms', + 'warehouse' = 'oss://bucket.cn-beijing.oss-dls.aliyuncs.com/path/to/paimon_warehouse', + 'hive.metastore.uris' = 'thrift://127.0.0.1:9383', + 'fs.oss.accessKeyId' = '', + 'fs.oss.accessKeySecret' = '', + 'fs.oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.access_key' = '', + 'oss.secret_key' = '', + 'oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.hdfs.enabled' = 'true', + 'fs.oss.impl' = 'com.aliyun.jindodata.oss.JindoOssFileSystem', + 'fs.AbstractFileSystem.oss.impl' = 'com.aliyun.jindodata.oss.OSS' + ); + ``` ```sql diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md index a61cabf7d6857..aa7e56913d525 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -12,6 +12,8 @@ 指标信息来源于 BE 的数据缓存相关监控指标。 +在存算分离模式下，该系统表仅返回当前查询所使用的计算组（Compute Group）中的 BE 节点信息。如果集群中存在多个计算组，查询结果可能只包含集群全部 BE 节点中的一部分。 + :::tip 提示 该系统表自 2.1.6 和 3.0.2 版本支持。 ::: diff --git a/versioned_docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md b/versioned_docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md index 7ba720aff3dc0..47a40446aeda5 100644 --- a/versioned_docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/versioned_docs/version-2.1/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -10,6 +10,8 @@ Used to view the metric information related to data cache on each BE node. The metric information is sourced from the monitoring metrics related to BE's data cache. +In compute-storage decoupled mode, this table only returns the BE nodes in the compute group used by the current query. If the cluster contains multiple compute groups, the query result may include only part of all BE nodes in the cluster. + :::tip Tip This system table is supported from versions 2.1.6 and 3.0.2. ::: diff --git a/versioned_docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx b/versioned_docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx index 716c72d9df84c..9801438510d73 100644 --- a/versioned_docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx +++ b/versioned_docs/version-2.1/lakehouse/catalogs/paimon-catalog.mdx @@ -341,6 +341,26 @@ The currently dependent Paimon version is 1.0.0. 'oss.secret_key' = '' ); ``` + + For Doris 2.1 and 3.0, when the Paimon table is stored in Alibaba Cloud OSS-HDFS and the path uses an OSS-HDFS endpoint such as `oss-dls.aliyuncs.com`, add the OSS-HDFS and Jindo FileSystem properties explicitly: + + ```sql + CREATE CATALOG paimon_hms_on_oss_hdfs_catalog PROPERTIES ( + 'type' = 'paimon', + 'paimon.catalog.type' = 'hms', + 'warehouse' = 'oss://bucket.cn-beijing.oss-dls.aliyuncs.com/path/to/paimon_warehouse', + 'hive.metastore.uris' = 'thrift://127.0.0.1:9383', + 'fs.oss.accessKeyId' = '', + 'fs.oss.accessKeySecret' = '', + 'fs.oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.access_key' = '', + 'oss.secret_key' = '', + 'oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.hdfs.enabled' = 'true', + 'fs.oss.impl' = 'com.aliyun.jindodata.oss.JindoOssFileSystem', + 'fs.AbstractFileSystem.oss.impl' = 'com.aliyun.jindodata.oss.OSS' + ); + ``` ```sql diff --git a/versioned_docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md b/versioned_docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md index 7ba720aff3dc0..47a40446aeda5 100644 --- a/versioned_docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/versioned_docs/version-3.x/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -10,6 +10,8 @@ Used to view the metric information related to data cache on each BE node. The metric information is sourced from the monitoring metrics related to BE's data cache. +In compute-storage decoupled mode, this table only returns the BE nodes in the compute group used by the current query. If the cluster contains multiple compute groups, the query result may include only part of all BE nodes in the cluster. + :::tip Tip This system table is supported from versions 2.1.6 and 3.0.2. ::: diff --git a/versioned_docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx b/versioned_docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx index b080aaee1eb20..b160fad970f09 100644 --- a/versioned_docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx +++ b/versioned_docs/version-3.x/lakehouse/catalogs/paimon-catalog.mdx @@ -428,6 +428,26 @@ Supported since version 4.0.3, `timestamp_with_local_time_zone` can be mapped to 'oss.secret_key' = '' ); ``` + + For Doris 2.1 and 3.0, when the Paimon table is stored in Alibaba Cloud OSS-HDFS and the path uses an OSS-HDFS endpoint such as `oss-dls.aliyuncs.com`, add the OSS-HDFS and Jindo FileSystem properties explicitly: + + ```sql + CREATE CATALOG paimon_hms_on_oss_hdfs_catalog PROPERTIES ( + 'type' = 'paimon', + 'paimon.catalog.type' = 'hms', + 'warehouse' = 'oss://bucket.cn-beijing.oss-dls.aliyuncs.com/path/to/paimon_warehouse', + 'hive.metastore.uris' = 'thrift://127.0.0.1:9383', + 'fs.oss.accessKeyId' = '', + 'fs.oss.accessKeySecret' = '', + 'fs.oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.access_key' = '', + 'oss.secret_key' = '', + 'oss.endpoint' = 'cn-beijing.oss-dls.aliyuncs.com', + 'oss.hdfs.enabled' = 'true', + 'fs.oss.impl' = 'com.aliyun.jindodata.oss.JindoOssFileSystem', + 'fs.AbstractFileSystem.oss.impl' = 'com.aliyun.jindodata.oss.OSS' + ); + ``` ```sql diff --git a/versioned_docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md b/versioned_docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md index 7ba720aff3dc0..47a40446aeda5 100644 --- a/versioned_docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/versioned_docs/version-4.x/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -10,6 +10,8 @@ Used to view the metric information related to data cache on each BE node. The metric information is sourced from the monitoring metrics related to BE's data cache. +In compute-storage decoupled mode, this table only returns the BE nodes in the compute group used by the current query. If the cluster contains multiple compute groups, the query result may include only part of all BE nodes in the cluster. + :::tip Tip This system table is supported from versions 2.1.6 and 3.0.2. ::: From ff68c4c41a38855fa8c3629b4b9dd34ae083f0a7 Mon Sep 17 00:00:00 2001 From: "Mingyu Chen (Rayner)" Date: Tue, 5 May 2026 17:04:24 -0700 Subject: [PATCH 2/2] add next --- .../system-tables/information_schema/file_cache_statistics.md | 2 ++ .../system-tables/information_schema/file_cache_statistics.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs-next/admin-manual/system-tables/information_schema/file_cache_statistics.md b/docs-next/admin-manual/system-tables/information_schema/file_cache_statistics.md index 7ba720aff3dc0..47a40446aeda5 100644 --- a/docs-next/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/docs-next/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -10,6 +10,8 @@ Used to view the metric information related to data cache on each BE node. The metric information is sourced from the monitoring metrics related to BE's data cache. +In compute-storage decoupled mode, this table only returns the BE nodes in the compute group used by the current query. If the cluster contains multiple compute groups, the query result may include only part of all BE nodes in the cluster. + :::tip Tip This system table is supported from versions 2.1.6 and 3.0.2. ::: diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs-next/current/admin-manual/system-tables/information_schema/file_cache_statistics.md b/i18n/zh-CN/docusaurus-plugin-content-docs-next/current/admin-manual/system-tables/information_schema/file_cache_statistics.md index a61cabf7d6857..aa7e56913d525 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs-next/current/admin-manual/system-tables/information_schema/file_cache_statistics.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs-next/current/admin-manual/system-tables/information_schema/file_cache_statistics.md @@ -12,6 +12,8 @@ 指标信息来源于 BE 的数据缓存相关监控指标。 +在存算分离模式下，该系统表仅返回当前查询所使用的计算组（Compute Group）中的 BE 节点信息。如果集群中存在多个计算组，查询结果可能只包含集群全部 BE 节点中的一部分。 + :::tip 提示 该系统表自 2.1.6 和 3.0.2 版本支持。 :::