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 5ac557237ac [opt](hive) add ignore_absent_partitions doc (#2863)
5ac557237ac is described below
commit 5ac557237ac25dbfda9a323ce82dd2372fcc95b4
Author: Mingyu Chen (Rayner) <morning...@163.com>
AuthorDate: Wed Sep 10 10:39:23 2025 -0700
[opt](hive) add ignore_absent_partitions doc (#2863)
## Versions
- [x] dev
- [x] 3.0
- [x] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
docs/lakehouse/catalogs/hive-catalog.md | 2 ++
docs/lakehouse/metastores/aliyun-dlf.md | 4 ++++
.../current/lakehouse/catalogs/hive-catalog.md | 2 ++
.../current/lakehouse/metastores/aliyun-dlf.md | 4 ++++
.../version-2.1/lakehouse/catalogs/hive-catalog.md | 4 ++++
.../version-2.1/lakehouse/metastores/aliyun-dlf.md | 4 ++++
.../version-3.0/lakehouse/catalogs/hive-catalog.md | 2 ++
.../version-3.0/lakehouse/metastores/aliyun-dlf.md | 4 ++++
versioned_docs/version-2.1/lakehouse/catalogs/hive-catalog.md | 6 +++++-
versioned_docs/version-2.1/lakehouse/metastores/aliyun-dlf.md | 4 ++++
versioned_docs/version-3.0/lakehouse/catalogs/hive-catalog.md | 2 ++
versioned_docs/version-3.0/lakehouse/metastores/aliyun-dlf.md | 4 ++++
12 files changed, 41 insertions(+), 1 deletion(-)
diff --git a/docs/lakehouse/catalogs/hive-catalog.md
b/docs/lakehouse/catalogs/hive-catalog.md
index 112aa8e14b6..90a908e686a 100644
--- a/docs/lakehouse/catalogs/hive-catalog.md
+++ b/docs/lakehouse/catalogs/hive-catalog.md
@@ -68,6 +68,8 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
* `hive.recursive_directories`: Whether to recurse into subdirectories when
listing partition directories. This parameter has been supported since version
3.0.2. Before version 4.0, this parameter defaulted to `false`; in later
versions, it defaults to `true`. The partition paths of some Hive tables may
not match the partition information in the table schema. Setting this parameter
to true is necessary to retrieve data files in subdirectories.
+ * `hive.ignore_absent_partitions`: Whether to ignore non-existent
partitions. Defaults to `true`. If set to `false`, the query will report an
error when encountering non-existent partitions. This parameter has been
supported since version 3.0.2.
+
### Supported Hive Versions
Supports Hive 1.x, 2.x, 3.x, and 4.x.
diff --git a/docs/lakehouse/metastores/aliyun-dlf.md
b/docs/lakehouse/metastores/aliyun-dlf.md
index 4b23e883125..fd24316ce21 100644
--- a/docs/lakehouse/metastores/aliyun-dlf.md
+++ b/docs/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@ This document describes how to use the `CREATE CATALOG`
statement to connect and
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID. Used to specify metadata
catalog. If not set, the default catalog is used. | None | No |
| `warehouse` | - | Storage path of the Warehouse, only required for Paimon
Catalog | None | No |
+> Note:
+>
+> For versions before 3.1.0, please use the former names.
+
### DLF 2.5+ (Rest Catalog)
> Supported since version 3.1.0
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/hive-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/hive-catalog.md
index cf04c327d97..0ce26897843 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/hive-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/hive-catalog.md
@@ -70,6 +70,8 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
* `hive.recursive_directories`：在list 分区目录时，是否递归子目录。该参数自 3.0.2 版本支持。在 4.0
版本之前，该参数默认值为 `false`，之后的版本，该默认值为 `true`。某些 Hive
外表的分区路径可能和表结构中的分区信息不匹配，需要将这个参数设为 `true` 以便获取子目录下的数据文件。
+ * `hive.ignore_absent_partitions`：是否忽略不存在的分区。默认为 `true`。如果设为
`false`，当遇到不存在的分区时，查询会报错。该参数自 3.0.2 版本支持。
+
### 支持的 Hive 版本
支持 Hive 1.x，2.x，3.x，4.x。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aliyun-dlf.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aliyun-dlf.md
index 50a197ae403..356f4e58af4 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aliyun-dlf.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID。用于指定元数据目录，如果不设置则使用默认目录。 | 无
| 否 |
| `warehouse` | - | Warehouse 的存储路径，仅在 Paimon Catalog 中需要填写 | 无 | 否 |
+> 注：
+>
+> 3.1.0 版本之前，请使用曾用名。
+
### DLF 2.5+ (Rest Catalog)
> 自 3.1.0 版本支持
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/hive-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/hive-catalog.md
index d8bdd9d9ed1..0ce26897843 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/hive-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/catalogs/hive-catalog.md
@@ -68,6 +68,10 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
* `get_schema_from_table`：默认为 false。默认情况下，Doris 会从 Hive Metastore 中获取表的
Schema 信息。但某些情况下可能出现兼容问题，如错误 `Storage schema reading not
supported`。此时可以将这个参数设置为 true，则会从 Table 对象中直接获取表
Schema。但注意，该方式会导致列的默认值信息被忽略。该参数自 2.1.10 和 3.0.6 版本支持。
+ * `hive.recursive_directories`：在list 分区目录时，是否递归子目录。该参数自 3.0.2 版本支持。在 4.0
版本之前，该参数默认值为 `false`，之后的版本，该默认值为 `true`。某些 Hive
外表的分区路径可能和表结构中的分区信息不匹配，需要将这个参数设为 `true` 以便获取子目录下的数据文件。
+
+ * `hive.ignore_absent_partitions`：是否忽略不存在的分区。默认为 `true`。如果设为
`false`，当遇到不存在的分区时，查询会报错。该参数自 3.0.2 版本支持。
+
### 支持的 Hive 版本
支持 Hive 1.x，2.x，3.x，4.x。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
index 50a197ae403..356f4e58af4 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID。用于指定元数据目录，如果不设置则使用默认目录。 | 无
| 否 |
| `warehouse` | - | Warehouse 的存储路径，仅在 Paimon Catalog 中需要填写 | 无 | 否 |
+> 注：
+>
+> 3.1.0 版本之前，请使用曾用名。
+
### DLF 2.5+ (Rest Catalog)
> 自 3.1.0 版本支持
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/catalogs/hive-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/catalogs/hive-catalog.md
index cf04c327d97..0ce26897843 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/catalogs/hive-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/catalogs/hive-catalog.md
@@ -70,6 +70,8 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
* `hive.recursive_directories`：在list 分区目录时，是否递归子目录。该参数自 3.0.2 版本支持。在 4.0
版本之前，该参数默认值为 `false`，之后的版本，该默认值为 `true`。某些 Hive
外表的分区路径可能和表结构中的分区信息不匹配，需要将这个参数设为 `true` 以便获取子目录下的数据文件。
+ * `hive.ignore_absent_partitions`：是否忽略不存在的分区。默认为 `true`。如果设为
`false`，当遇到不存在的分区时，查询会报错。该参数自 3.0.2 版本支持。
+
### 支持的 Hive 版本
支持 Hive 1.x，2.x，3.x，4.x。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
index 50a197ae403..356f4e58af4 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID。用于指定元数据目录，如果不设置则使用默认目录。 | 无
| 否 |
| `warehouse` | - | Warehouse 的存储路径，仅在 Paimon Catalog 中需要填写 | 无 | 否 |
+> 注：
+>
+> 3.1.0 版本之前，请使用曾用名。
+
### DLF 2.5+ (Rest Catalog)
> 自 3.1.0 版本支持
diff --git a/versioned_docs/version-2.1/lakehouse/catalogs/hive-catalog.md
b/versioned_docs/version-2.1/lakehouse/catalogs/hive-catalog.md
index 997854eb16b..90a908e686a 100644
--- a/versioned_docs/version-2.1/lakehouse/catalogs/hive-catalog.md
+++ b/versioned_docs/version-2.1/lakehouse/catalogs/hive-catalog.md
@@ -64,7 +64,11 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
OtherProperties section is for entering properties related to Hive Catalog.
- * `get_schema_from_table`：The default value is false. By default, Doris will
obtain the table schema information from the Hive Metastore. However, in some
cases, compatibility issues may occur, such as the error `Storage schema
reading not supported`. In this case, you can set this parameter to true, and
the table schema will be obtained directly from the Table object. But please
note that this method will cause the default value information of the column to
be ignored. This property i [...]
+ * `get_schema_from_table`: The default value is false. By default, Doris
will obtain the table schema information from the Hive Metastore. However, in
some cases, compatibility issues may occur, such as the error `Storage schema
reading not supported`. In this case, you can set this parameter to true, and
the table schema will be obtained directly from the Table object. But please
note that this method will cause the default value information of the column to
be ignored. This property [...]
+
+ * `hive.recursive_directories`: Whether to recurse into subdirectories when
listing partition directories. This parameter has been supported since version
3.0.2. Before version 4.0, this parameter defaulted to `false`; in later
versions, it defaults to `true`. The partition paths of some Hive tables may
not match the partition information in the table schema. Setting this parameter
to true is necessary to retrieve data files in subdirectories.
+
+ * `hive.ignore_absent_partitions`: Whether to ignore non-existent
partitions. Defaults to `true`. If set to `false`, the query will report an
error when encountering non-existent partitions. This parameter has been
supported since version 3.0.2.
### Supported Hive Versions
diff --git a/versioned_docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
b/versioned_docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
index 4b23e883125..fd24316ce21 100644
--- a/versioned_docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
+++ b/versioned_docs/version-2.1/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@ This document describes how to use the `CREATE CATALOG`
statement to connect and
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID. Used to specify metadata
catalog. If not set, the default catalog is used. | None | No |
| `warehouse` | - | Storage path of the Warehouse, only required for Paimon
Catalog | None | No |
+> Note:
+>
+> For versions before 3.1.0, please use the former names.
+
### DLF 2.5+ (Rest Catalog)
> Supported since version 3.1.0
diff --git a/versioned_docs/version-3.0/lakehouse/catalogs/hive-catalog.md
b/versioned_docs/version-3.0/lakehouse/catalogs/hive-catalog.md
index 112aa8e14b6..90a908e686a 100644
--- a/versioned_docs/version-3.0/lakehouse/catalogs/hive-catalog.md
+++ b/versioned_docs/version-3.0/lakehouse/catalogs/hive-catalog.md
@@ -68,6 +68,8 @@ CREATE CATALOG [IF NOT EXISTS] catalog_name PROPERTIES (
* `hive.recursive_directories`: Whether to recurse into subdirectories when
listing partition directories. This parameter has been supported since version
3.0.2. Before version 4.0, this parameter defaulted to `false`; in later
versions, it defaults to `true`. The partition paths of some Hive tables may
not match the partition information in the table schema. Setting this parameter
to true is necessary to retrieve data files in subdirectories.
+ * `hive.ignore_absent_partitions`: Whether to ignore non-existent
partitions. Defaults to `true`. If set to `false`, the query will report an
error when encountering non-existent partitions. This parameter has been
supported since version 3.0.2.
+
### Supported Hive Versions
Supports Hive 1.x, 2.x, 3.x, and 4.x.
diff --git a/versioned_docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
b/versioned_docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
index 4b23e883125..fd24316ce21 100644
--- a/versioned_docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
+++ b/versioned_docs/version-3.0/lakehouse/metastores/aliyun-dlf.md
@@ -24,6 +24,10 @@ This document describes how to use the `CREATE CATALOG`
statement to connect and
| `dlf.catalog_id` | `dlf.catalog.id` | Catalog ID. Used to specify metadata
catalog. If not set, the default catalog is used. | None | No |
| `warehouse` | - | Storage path of the Warehouse, only required for Paimon
Catalog | None | No |
+> Note:
+>
+> For versions before 3.1.0, please use the former names.
+
### DLF 2.5+ (Rest Catalog)
> Supported since version 3.1.0
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
