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 c953022c3bf [doc](lakehouse) Document OSS Tables support from 4.1.4
(#4084)
c953022c3bf is described below
commit c953022c3bf942949852fb179e3a66bb978c213a
Author: Chenjunwei <[email protected]>
AuthorDate: Fri Oct 16 14:39:25 2026 -0700
[doc](lakehouse) Document OSS Tables support from 4.1.4 (#4084)
## Summary
Document OSS Tables support from Doris 4.1.4 in the dev and 4.x
English/Chinese guides and Iceberg Catalog entries. Add the complete
guide and navigation to 4.x, and include the expected insert/query
result.
## Verified availability
The implementation in apache/doris#66823 merged into branch-4.1. The
4.1.4 source tag already contains `isOssTables`, `osstables` SigV4
validation and OSS credential routing in IcebergRestProperties; 4.1.3
does not. The previous 4.2-only claim was therefore too restrictive.
Current master and branch-4.2 also contain the implementation.
## Validation
Rebased on website master; checked source configuration/defaults, OSS
credential routing and bilingual version parity. `git diff --check` and
4.x sidebar JSON parsing pass. Cloud credentials were not available for
an end-to-end OSS request.
## Versions / languages
- dev and 4.x
- English and Chinese
---------
Co-authored-by: morningman <[email protected]>
---
.../best-practices/doris-aliyun-oss-tables.md | 8 +++++-
docs/lakehouse/catalogs/iceberg-catalog.mdx | 2 +-
.../best-practices/doris-aliyun-oss-tables.md | 8 +++++-
.../current/lakehouse/catalogs/iceberg-catalog.mdx | 2 +-
.../best-practices/doris-aliyun-oss-tables.md | 8 +++++-
.../lakehouse/catalogs/iceberg-catalog.mdx | 32 +++++++++++++++++++++-
.../best-practices/doris-aliyun-oss-tables.md | 8 +++++-
.../lakehouse/catalogs/iceberg-catalog.mdx | 30 ++++++++++++++++++++
versioned_sidebars/version-4.x-sidebars.json | 1 +
9 files changed, 92 insertions(+), 7 deletions(-)
diff --git a/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
b/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
index 47c9e8ad50a..b5b7dc09f48 100644
--- a/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
+++ b/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
@@ -33,7 +33,7 @@ Compared with managing Iceberg tables in a regular OSS
Bucket, OSS Tables provid
Apache Doris connects to OSS Tables through Iceberg REST Catalog: REST Catalog
manages namespaces and table metadata, while `S3FileIO` reads and writes data
files. This guide explains how to create an OSS Tables Catalog in Doris and
query and write Iceberg tables.
:::caution
-This feature is experimental and will be released in Doris 5.0.0.
+This feature is experimental and supported starting from Doris 4.1.4.
:::
<!-- Knowledge Type: Operational Steps -->
@@ -163,6 +163,12 @@ FROM orders
ORDER BY order_id;
```
+```text
+order_id customer amount created_at
+1 Alice 99.50 2026-08-11 10:00:00
+2 Bob 120.00 2026-08-11 10:01:00
+```
+
You can query the Iceberg `$files` metadata table to verify that data files
have been written to OSS Tables:
```sql
diff --git a/docs/lakehouse/catalogs/iceberg-catalog.mdx
b/docs/lakehouse/catalogs/iceberg-catalog.mdx
index 0063aeb79d8..1f861c6dcaf 100644
--- a/docs/lakehouse/catalogs/iceberg-catalog.mdx
+++ b/docs/lakehouse/catalogs/iceberg-catalog.mdx
@@ -1480,7 +1480,7 @@ This is an experimental feature, supported since version
4.1.0.
### Alibaba Cloud OSS Tables
<details>
- <summary>5.0+ Version</summary>
+ <summary>4.1.4+ Version</summary>
<Tabs>
<TabItem value='OSS Tables REST Catalog' label='OSS Tables REST
Catalog' default>
For complete configuration and usage instructions, see [Alibaba
Cloud OSS Tables Integration](../best-practices/doris-aliyun-oss-tables).
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
index 3a8ebebcd26..8cbf5b03dd0 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
@@ -34,7 +34,7 @@
Apache Doris 可以通过 Iceberg REST Catalog 接入 OSS Tables：使用 REST Catalog 管理
Namespace 和表元数据，使用 `S3FileIO` 读写数据文件。本文介绍如何在 Doris 中创建 OSS Tables
Catalog，并查询和写入 Iceberg 表。
:::caution
-该功能目前为实验功能，将在 Doris 5.0.0 版本中发布。
+该功能目前为实验功能，自 Doris 4.1.4 版本起支持。
:::
<!-- 知识类型: 操作步骤 -->
@@ -164,6 +164,12 @@ FROM orders
ORDER BY order_id;
```
+```text
+order_id customer amount created_at
+1 Alice 99.50 2026-08-11 10:00:00
+2 Bob 120.00 2026-08-11 10:01:00
+```
+
可以通过 Iceberg `$files` 元数据表确认数据文件已经写入 OSS Tables：
```sql
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
index 1028dadf906..f285aa7fbba 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/catalogs/iceberg-catalog.mdx
@@ -1496,7 +1496,7 @@ Rest Catalog requires signing-region and sigv4-enabled
set to true when signing-
### 阿里云 OSS Tables
<details>
- <summary>5.0+ 版本</summary>
+ <summary>4.1.4+ 版本</summary>
<Tabs>
<TabItem value='OSS Tables REST Catalog' label='OSS Tables REST
Catalog' default>
完整配置和使用说明请参阅[集成阿里云 OSS
Tables](../best-practices/doris-aliyun-oss-tables)。
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
similarity index 97%
copy from
i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
copy to
i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
index 3a8ebebcd26..8cbf5b03dd0 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-aliyun-oss-tables.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
@@ -34,7 +34,7 @@
Apache Doris 可以通过 Iceberg REST Catalog 接入 OSS Tables：使用 REST Catalog 管理
Namespace 和表元数据，使用 `S3FileIO` 读写数据文件。本文介绍如何在 Doris 中创建 OSS Tables
Catalog，并查询和写入 Iceberg 表。
:::caution
-该功能目前为实验功能，将在 Doris 5.0.0 版本中发布。
+该功能目前为实验功能，自 Doris 4.1.4 版本起支持。
:::
<!-- 知识类型: 操作步骤 -->
@@ -164,6 +164,12 @@ FROM orders
ORDER BY order_id;
```
+```text
+order_id customer amount created_at
+1 Alice 99.50 2026-08-11 10:00:00
+2 Bob 120.00 2026-08-11 10:01:00
+```
+
可以通过 Iceberg `$files` 元数据表确认数据文件已经写入 OSS Tables：
```sql
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
index ca4e503a891..258f07ccdb1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
@@ -1511,6 +1511,36 @@ Rest Catalog requires signing-region and sigv4-enabled
set to true when signing-
</Tabs>
</details>
+### 阿里云 OSS Tables
+
+<details>
+ <summary>4.1.4+ 版本</summary>
+ <Tabs>
+ <TabItem value='OSS Tables REST Catalog' label='OSS Tables REST
Catalog' default>
+ 完整配置和使用说明请参阅[集成阿里云 OSS
Tables](../best-practices/doris-aliyun-oss-tables)。
+ ```sql
+ CREATE CATALOG oss_tables PROPERTIES (
+ 'type' = 'iceberg',
+ 'iceberg.catalog.type' = 'rest',
+ 'iceberg.rest.uri' =
'https://<region>.oss-tables.aliyuncs.com/iceberg',
+ 'warehouse' =
'acs:osstables:<region>:<account_id>:bucket/<table_bucket_name>',
+ 'iceberg.rest.sigv4-enabled' = 'true',
+ 'iceberg.rest.signing-name' = 'osstables',
+ 'iceberg.rest.signing-region' = '<region>',
+ 'iceberg.rest.view-enabled' = 'false',
+ 'io-impl' = 'org.apache.iceberg.aws.s3.S3FileIO',
+ 'oss.endpoint' = 'https://oss-<region>.aliyuncs.com',
+ 'oss.region' = '<region>',
+ 'oss.access_key' = '<access_key_id>',
+ 'oss.secret_key' = '<access_key_secret>',
+ 'oss.use_path_style' = 'false',
+ 'test_connection' = 'true'
+ );
+ ```
+ </TabItem>
+ </Tabs>
+</details>
+
## 查询操作
### 基础查询
@@ -2966,7 +2996,7 @@ EXECUTE rewrite_data_files (
1. `rewrite_data_files` 操作会读取数据文件并重新写入，会产生额外的 I/O 和计算开销，请合理分配集群资源。
2. 执行前可以通过[查看数据文件分布](#查看数据文件分布)章节中的 SQL 来评估是否需要执行重写操作。
3. WHERE 条件可用于限制重写的分区或数据范围，这个条件会过滤掉那些不包含符合 WHERE 条件的数据的文件，从而减少重写的文件数量和数据量。
-4. 执行前可以通过[重写文件选择逻辑](#重写文件选择逻辑)章节中的 SQL 来计算哪些文件会被重写。
+4. 执行前可以通过[重写文件选择逻辑](#rewrite_data_files-文件选择策略)章节中的 SQL 来计算哪些文件会被重写。
### rewrite_manifests
diff --git a/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
b/versioned_docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
similarity index 97%
copy from docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
copy to
versioned_docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
index 47c9e8ad50a..b5b7dc09f48 100644
--- a/docs/lakehouse/best-practices/doris-aliyun-oss-tables.md
+++
b/versioned_docs/version-4.x/lakehouse/best-practices/doris-aliyun-oss-tables.md
@@ -33,7 +33,7 @@ Compared with managing Iceberg tables in a regular OSS
Bucket, OSS Tables provid
Apache Doris connects to OSS Tables through Iceberg REST Catalog: REST Catalog
manages namespaces and table metadata, while `S3FileIO` reads and writes data
files. This guide explains how to create an OSS Tables Catalog in Doris and
query and write Iceberg tables.
:::caution
-This feature is experimental and will be released in Doris 5.0.0.
+This feature is experimental and supported starting from Doris 4.1.4.
:::
<!-- Knowledge Type: Operational Steps -->
@@ -163,6 +163,12 @@ FROM orders
ORDER BY order_id;
```
+```text
+order_id customer amount created_at
+1 Alice 99.50 2026-08-11 10:00:00
+2 Bob 120.00 2026-08-11 10:01:00
+```
+
You can query the Iceberg `$files` metadata table to verify that data files
have been written to OSS Tables:
```sql
diff --git a/versioned_docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
b/versioned_docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
index 3f68976d486..09af8167a25 100644
--- a/versioned_docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
+++ b/versioned_docs/version-4.x/lakehouse/catalogs/iceberg-catalog.mdx
@@ -1491,6 +1491,36 @@ This is an experimental feature, supported since version
4.1.0.
</Tabs>
</details>
+### Alibaba Cloud OSS Tables
+
+<details>
+ <summary>4.1.4+ Version</summary>
+ <Tabs>
+ <TabItem value='OSS Tables REST Catalog' label='OSS Tables REST
Catalog' default>
+ For complete configuration and usage instructions, see [Alibaba
Cloud OSS Tables Integration](../best-practices/doris-aliyun-oss-tables).
+ ```sql
+ CREATE CATALOG oss_tables PROPERTIES (
+ 'type' = 'iceberg',
+ 'iceberg.catalog.type' = 'rest',
+ 'iceberg.rest.uri' =
'https://<region>.oss-tables.aliyuncs.com/iceberg',
+ 'warehouse' =
'acs:osstables:<region>:<account_id>:bucket/<table_bucket_name>',
+ 'iceberg.rest.sigv4-enabled' = 'true',
+ 'iceberg.rest.signing-name' = 'osstables',
+ 'iceberg.rest.signing-region' = '<region>',
+ 'iceberg.rest.view-enabled' = 'false',
+ 'io-impl' = 'org.apache.iceberg.aws.s3.S3FileIO',
+ 'oss.endpoint' = 'https://oss-<region>.aliyuncs.com',
+ 'oss.region' = '<region>',
+ 'oss.access_key' = '<access_key_id>',
+ 'oss.secret_key' = '<access_key_secret>',
+ 'oss.use_path_style' = 'false',
+ 'test_connection' = 'true'
+ );
+ ```
+ </TabItem>
+ </Tabs>
+</details>
+
## Query Operations
### Basic Query
diff --git a/versioned_sidebars/version-4.x-sidebars.json
b/versioned_sidebars/version-4.x-sidebars.json
index 833243addc3..18b4884953f 100644
--- a/versioned_sidebars/version-4.x-sidebars.json
+++ b/versioned_sidebars/version-4.x-sidebars.json
@@ -786,6 +786,7 @@
"items": [
"lakehouse/best-practices/doris-iceberg",
"lakehouse/best-practices/doris-aws-s3tables",
+ "lakehouse/best-practices/doris-aliyun-oss-tables",
"lakehouse/best-practices/doris-polaris",
"lakehouse/best-practices/doris-gravitino",
"lakehouse/best-practices/doris-onelake",
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
