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 67b415c77b5 [lakehouse](storage) add s3 directory bucket doc (#2551)
67b415c77b5 is described below
commit 67b415c77b58d7af4515740f44666c456972f698
Author: zy-kkk <[email protected]>
AuthorDate: Thu Jul 3 12:00:54 2025 +0800
[lakehouse](storage) add s3 directory bucket doc (#2551)
## Versions
- [x] dev
- [ ] 3.0
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---------
Co-authored-by: Mingyu Chen (Rayner) <[email protected]>
---
docs/lakehouse/storages/s3.md | 61 ++++++++++++----------
.../current/lakehouse/storages/s3.md | 41 ++++++++++++---
2 files changed, 69 insertions(+), 33 deletions(-)
diff --git a/docs/lakehouse/storages/s3.md b/docs/lakehouse/storages/s3.md
index 2142920da78..f19fef4c331 100644
--- a/docs/lakehouse/storages/s3.md
+++ b/docs/lakehouse/storages/s3.md
@@ -5,32 +5,6 @@
}
---
----
-{
- "title": "S3",
- "language": "zh-CN"
-}
----
-
-<!--
-Licensed to the Apache Software Foundation (ASF) under one
-or more contributor license agreements. See the NOTICE file
-distributed with this work for additional information
-regarding copyright ownership. The ASF licenses this file
-to you under the Apache License, Version 2.0 (the
-"License"); you may not use this file except in compliance
-with the License. You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing,
-software distributed under the License is distributed on an
-"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, either express or implied. See the License for the
-specific language governing permissions and limitations
-under the License.
--->
-
This document describes the parameters required for accessing AWS S3. These
parameters apply to:
- Catalog properties
@@ -58,7 +32,11 @@ When accessing AWS S3, you need to provide AWS Access Key
and AWS Secret Key, wh
- s3.access_key
- s3.secret_key
-### Example Configuration
+When accessing AWS S3, Doris also supports the Assumed Role method. Please
refer to the following documentation for configuration:
+[AWS
integration](../../admin-manual/auth/integrations/aws-authentication-and-authorization.md#assumed-role-authentication).
+
+
+### Configuration Example
```properties
"s3.access_key" = "ak"
@@ -66,3 +44,32 @@ When accessing AWS S3, you need to provide AWS Access Key
and AWS Secret Key, wh
"s3.endpoint" = "s3.us-east-1.amazonaws.com"
"s3.region" = "us-east-1"
```
+
+## Directory Bucket
+
+Directory Bucket is a high-performance storage option for Amazon S3 Express
One Zone storage class. When using Directory Bucket, the main difference is in
the configuration format of `s3.endpoint`, while other configuration parameters
remain unchanged.
+
+#### Endpoint Configuration Differences
+
+- General S3 Bucket
+
+ ```
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com"
+ ```
+
+- Directory Bucket
+
+ ```
+ "s3.endpoint" = "s3express-{zone-id}.{region}.amazonaws.com"
+ ```
+
+#### Directory Bucket Configuration Example
+
+```properties
+"s3.access_key" = "ak"
+"s3.secret_key" = "sk"
+"s3.endpoint" = "s3express-usw2-az1.us-west-2.amazonaws.com"
+"s3.region" = "us-west-2"
+```
+
+Where `s3express-usw2-az1.us-west-2.amazonaws.com` is the dedicated endpoint
format for Directory Bucket. For more endpoint addresses, please refer to the
[AWS official
documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html).
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/s3.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/s3.md
index 82f18100d25..0bd13bdabd4 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/s3.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/s3.md
@@ -24,24 +24,53 @@
| `s3.connection.maximum` | | S3 最大连接数
| `50` | 否 |
| `s3.connection.request.timeout` | | S3 请求超时时间，单位毫秒
| `3000` | 否 |
| `s3.connection.timeout` | | S3 连接超时时间，单位毫秒
| `1000` | 否 |
-| `s3.role_arn` | | assume role方式会用到
| | 否 |
-| `s3.external_id` | | assume role方式会用到
| | 否 |
+| `s3.role_arn` | | assume role 方式会用到
| | 否 |
+| `s3.external_id` | | assume role 方式会用到
| | 否 |
### 认证配置
-访问 AWS S3 时，需要提供 AWS Access Key 和 AWS Secret Key， 即下列参数：
+访问 AWS S3 时，需要提供 AWS Access Key 和 AWS Secret Key，即下列参数：
- s3.access_key
- s3.secret_key
-访问 AWS S3时，Doris也支持Assumed Role的方式，请参考如下文档进行配置
+访问 AWS S3 时，Doris 也支持 Assumed Role 的方式，请参考如下文档进行配置
[AWS
intergration](../../admin-manual/auth/integrations/aws-authentication-and-authorization.md#assumed-role-authentication).
-### 示例配置
+### 配置示例
```properties
"s3.access_key" = "ak"
"s3.secret_key" = "sk"
"s3.endpoint" = "s3.us-east-1.amazonaws.com"
"s3.region" = "us-east-1"
-```
\ No newline at end of file
+```
+
+## Directory Bucket
+
+Directory Bucket 是 Amazon S3 Express One Zone 存储类的高性能存储选项。使用 Directory Bucket
时，主要区别在于 `s3.endpoint` 的配置格式不同，其他配置参数保持不变。
+
+#### Endpoint 配置区别
+
+- General S3 Bucket
+
+ ```
+ "s3.endpoint" = "s3.us-east-1.amazonaws.com"
+ ```
+
+- Directory Bucket
+
+ ```
+ "s3.endpoint" = "s3express-{zone-id}.{region}.amazonaws.com"
+ ```
+
+#### Directory Bucket 配置示例
+
+```properties
+"s3.access_key" = "ak"
+"s3.secret_key" = "sk"
+"s3.endpoint" = "s3express-usw2-az1.us-west-2.amazonaws.com"
+"s3.region" = "us-west-2"
+```
+
+其中 `s3express-usw2-az1.us-west-2.amazonaws.com` 是 Directory Bucket 专用的
endpoint 格式，更多 endpoint 地址请参考 [AWS
官方文档](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html)。
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
