[doc](s3) Fix the wrong property name for path-style access

docs/lakehouse/storages/aliyun-oss.md

@@ -26,7 +26,7 @@
 | oss.access_key                 | s3.access_key                | OSS Access Key for authentication                            | None          |
 | oss.secret_key                 | s3.secret_key                | OSS Secret Key, used together with Access Key               | None          |
 | oss.region                     | s3.region                    | OSS region, specifies the region of Alibaba Cloud OSS       | None          |
-| oss.use_path_style             | s3.use_path_style            | Whether to use path-style access. Recommended to set to true for compatibility with MinIO and other non-AWS S3 services | FALSE         |
+| oss.use_path_style             | use_path_style               | Whether to use path-style access. Recommended to set to true for compatibility with MinIO and other non-AWS S3 services | FALSE         |
 | oss.connection.maximum         | s3.connection.maximum        | Maximum number of connections, specifies the maximum number of connections established with OSS service | 50            |
 | oss.connection.request.timeout | s3.connection.request.timeout| Request timeout (milliseconds), specifies the request timeout when connecting to OSS service | 3000          |
 | oss.connection.timeout         | s3.connection.timeout        | Connection timeout (milliseconds), specifies the timeout when establishing connection with OSS service | 1000          |
@@ -37,7 +37,7 @@
 
 ```properties
 "oss.access_key" = "your-access-key",
 "oss.secret_key" = "your-secret-key",
 "oss.endpoint" = "oss-cn-beijing.aliyuncs.com",
 "oss.region" = "cn-beijing"
 ```
@@ -107,7 +107,7 @@
 ```properties
 "fs.oss-hdfs.support" = "true",
 "oss.hdfs.access_key" = "your-access-key",
 "oss.hdfs.secret_key" = "your-secret-key",
 "oss.hdfs.endpoint" = "cn-hangzhou.oss-dls.aliyuncs.com",
 "oss.hdfs.region" = "cn-hangzhou"
 ```

docs/lakehouse/storages/huawei-obs.md

@@ -24,7 +24,7 @@ This document describes the parameters required to access Huawei Cloud OBS, whic
 | obs.access_key               | s3.access_key            | OBS access key, used for authentication                     |               | Yes      |
 | obs.secret_key               | s3.secret_key            | OBS secret key, used together with access key for authentication |               | Yes      |
 | obs.region                   | s3.region                | OBS region, specifies the region of Huawei Cloud OBS        |               | No       |
-| obs.use_path_style           | s3.use_path_style        | Whether to use path-style access. Recommended to set to true for compatibility with non-AWS S3 services like MinIO/Ceph | FALSE         | No       |
+| obs.use_path_style           | use_path_style           | Whether to use path-style access. Recommended to set to true for compatibility with non-AWS S3 services like MinIO/Ceph | FALSE         | No       |
 | obs.connection.maximum       | s3.connection.maximum    | Maximum number of connections to OBS service                | 50            | No       |
 | obs.connection.request.timeout | s3.connection.request.timeout | Request timeout in milliseconds for connecting to OBS service | 3000          | No       |
 | obs.connection.timeout       | s3.connection.timeout    | Connection timeout in milliseconds for establishing connection to OBS service | 1000          | No       |

docs/lakehouse/storages/minio.md

@@ -29,7 +29,7 @@ This document describes the parameters required to access MinIO, which apply to
 | minio.connection.maximum       | s3.connection.maximum    | S3 maximum connections, specifies the maximum number of connections established with MinIO service | 50            | No       |
 | minio.connection.request.timeout | s3.connection.request.timeout | S3 request timeout, in milliseconds, specifies the request timeout when connecting to MinIO service | 3000          | No       |
 | minio.connection.timeout       | s3.connection.timeout    | S3 connection timeout, in milliseconds, specifies the timeout when establishing connection with MinIO service | 1000          | No       |
-| minio.use_path_style           | s3.use_path_style        | Whether to use path-style access. Recommended to set to true for compatibility with MinIO and other non-AWS S3 services | FALSE         | No       |
+| minio.use_path_style           | use_path_style           | Whether to use path-style access. Recommended to set to true for compatibility with MinIO and other non-AWS S3 services | FALSE         | No       |
 
 ### Using Path-style Access
 

docs/lakehouse/storages/s3.md

@@ -63,7 +63,7 @@
 | s3.access_key                |                               | AWS Access Key for authentication                                           | None    | No       |
 | s3.secret_key                |                               | AWS Secret Key for authentication                                           | None    | No       |
 | s3.region                    |                               | S3 region, e.g., `us-east-1`. Strongly recommended                         | None    | Yes      |
-| s3.use_path_style            |                               | Whether to use path-style access                                            | FALSE   | No       |
+| use_path_style               | s3.path-style-access           | Whether to use path-style access                                            | FALSE   | No       |
 | s3.connection.maximum        |                               | Maximum number of connections for high concurrency scenarios                | 50      | No       |
 | s3.connection.request.timeout|                               | Request timeout (milliseconds), controls connection acquisition timeout     | 3000    | No       |
 | s3.connection.timeout        |                               | Connection establishment timeout (milliseconds)                             | 1000    | No       |
@@ -73,6 +73,8 @@
 
 > Version note: `s3.credentials_provider_type` is supported since **3.1.4** and **4.0.3**.
 
+> Property name note: the parameter that enables path-style access is `use_path_style`. It has no `s3.` prefix: `s3.use_path_style` is not a recognized property and has no effect. `s3.path-style-access` is accepted as an alias, and S3-compatible services also accept their own prefixed spelling, such as `oss.use_path_style`, `obs.use_path_style`, `minio.use_path_style`, or `ozone.use_path_style`.
+
 ## Authentication Configuration
 
 Doris supports the following three methods to access S3:
@@ -191,7 +193,7 @@
 * Regular bucket: s3.us-east-1.amazonaws.com
 * Directory Bucket: s3express-usw2-az1.us-west-2.amazonaws.com
 
 For more available regions, refer to: [AWS Official Documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html)
 
 Example:
 

docs/lakehouse/storages/seaweedfs.md

@@ -9,7 +9,7 @@
 
 # SeaweedFS
 
 This document describes the parameters required to access [SeaweedFS](https://seaweedfs.com/), which apply to the following scenarios:
 
 - Catalog properties
 - Table Valued Function properties
@@ -30,7 +30,7 @@
 weed mini -dir=/data
 ```
 
 The S3 endpoint is then reachable at `http://localhost:8333` with `my-bucket` already created and `admin` / `secret` as valid credentials. See [Quick Start with `weed mini`](https://github.com/seaweedfs/seaweedfs/wiki/Quick-Start-with-weed-mini) for Docker, custom ports, multiple buckets, and reverse-proxy options.
 
 ## Parameter Overview
 
@@ -42,14 +42,14 @@
 | s3.access_key                   | Access key configured in the SeaweedFS S3 IAM config                                                  |         | Yes      |
 | s3.secret_key                   | Secret key paired with `s3.access_key`                                                                |         | Yes      |
 | s3.region                       | Region. SeaweedFS does not validate the value but the AWS S3 SDK requires one, e.g. `us-east-1`       |         | Yes      |
-| s3.use_path_style               | Set to `true`. SeaweedFS serves objects under `http://<endpoint>/<bucket>/<key>`                       | FALSE   | No       |
+| use_path_style                  | Set to `true`. SeaweedFS serves objects under `http://<endpoint>/<bucket>/<key>`                       | FALSE   | No       |
 | s3.connection.maximum           | Maximum number of connections to the SeaweedFS S3 gateway                                              | 50      | No       |
 | s3.connection.request.timeout   | Request timeout in milliseconds                                                                        | 3000    | No       |
 | s3.connection.timeout           | Connection establishment timeout in milliseconds                                                       | 1000    | No       |
 
 ### Using path-style access
 
-SeaweedFS uses path-style addressing (`http://<endpoint>/<bucket>/<key>`) and does not provision per-bucket DNS subdomains, so set `s3.use_path_style = true` for every connection.
+SeaweedFS uses path-style addressing (`http://<endpoint>/<bucket>/<key>`) and does not provision per-bucket DNS subdomains, so set `use_path_style = true` for every connection.
 
 ## Example Configuration
 
@@ -58,12 +58,12 @@
 "s3.secret_key" = "your-secret-key",
 "s3.endpoint" = "http://seaweedfs.example.com:8333",
 "s3.region" = "us-east-1",
-"s3.use_path_style" = "true"
+"use_path_style" = "true"
 ```
 
 ## Usage Recommendations
 
-* Set `s3.use_path_style = true`. SeaweedFS does not use per-bucket DNS subdomains.
+* Set `use_path_style = true`. SeaweedFS does not use per-bucket DNS subdomains.
 * `s3.region` is required by the AWS S3 SDK but ignored by SeaweedFS — any non-empty value works.
 * For HTTPS, terminate TLS at a reverse proxy and start `weed` with `-s3.externalUrl=https://<proxy>` so S3 signature verification works.
 * For Iceberg tables in SeaweedFS S3 Table Buckets, see [Integration with SeaweedFS](../best-practices/doris-seaweedfs.md).

i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/aliyun-oss.md

@@ -1,4 +1,4 @@
 ---
 {
     "title": "Aliyun OSS",
     "language": "zh-CN",
@@ -27,7 +27,7 @@
 | oss.secret_key                 | s3.secret_key                | OSS Secret Key，与 Access Key 配合使用                       | 无     |
 | oss.session_token              | s3.session_token             | OSS 临时安全令牌（STS Security Token），使用临时访问凭证时与临时 AK/SK 配合使用。自 4.0.6 版本起支持。 | 无     |
 | oss.region                     | s3.region                    | OSS region，指定阿里云 OSS 的区域                             | 无     |
-| oss.use_path_style             | s3.use_path_style            | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  |
+| oss.use_path_style             | use_path_style               | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  |
 | oss.connection.maximum         | s3.connection.maximum        | 最大连接数，指定与 OSS 服务建立的最大连接数                  | 50     |
 | oss.connection.request.timeout | s3.connection.request.timeout| 请求超时时间（毫秒），指定连接 OSS 服务时的请求超时时间       | 3000   |
 | oss.connection.timeout         | s3.connection.timeout        | 连接超时时间（毫秒），指定与 OSS 服务建立连接时的超时时间     | 1000   |
@@ -38,7 +38,7 @@
 
 ```properties
 "oss.access_key" = "your-access-key",
 "oss.secret_key" = "your-secret-key",
 "oss.endpoint" = "oss-cn-beijing.aliyuncs.com",
 "oss.region" = "cn-beijing"
 ```
@@ -109,7 +109,7 @@
 ```properties
 "fs.oss-hdfs.support" = "true",
 "oss.hdfs.access_key" = "your-access-key",
 "oss.hdfs.secret_key" = "your-secret-key",
 "oss.hdfs.endpoint" = "cn-hangzhou.oss-dls.aliyuncs.com",
 "oss.hdfs.region" = "cn-hangzhou"
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/huawei-obs.md

@@ -1,4 +1,4 @@
 ---
 {
     "title": "Huawei OBS",
     "language": "zh-CN",
@@ -24,7 +24,7 @@
 | obs.access_key               | s3.access_key            | OBS access key，用于身份验证的 OBS 访问密钥                  |        | 是       |
 | obs.secret_key               | s3.secret_key            | OBS secret key，与 access key 配合使用的访问密钥             |        | 是       |
 | obs.region                   | s3.region                | OBS region，指定华为云 OBS 的区域                            |        | 否       |
-| obs.use_path_style           | s3.use_path_style        | 是否使用 path-style（路径风格）访问。兼容 MinIO/Ceph 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
+| obs.use_path_style           | use_path_style           | 是否使用 path-style（路径风格）访问。兼容 MinIO/Ceph 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
 | obs.connection.maximum       | s3.connection.maximum    | 最大连接数，指定与 OBS 服务建立的最大连接数                  | 50     | 否       |
 | obs.connection.request.timeout | s3.connection.request.timeout | 请求超时时间，单位为毫秒，指定连接 OBS 服务时的请求超时时间  | 3000   | 否       |
 | obs.connection.timeout       | s3.connection.timeout    | 连接超时时间，单位为毫秒，指定与 OBS 服务建立连接时的超时时间 | 1000   | 否       |

i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/minio.md

@@ -29,7 +29,7 @@
 | minio.connection.maximum       | s3.connection.maximum    | S3 最大连接数，指定与 Minio 服务建立的最大连接数              | 50     | 否       |
 | minio.connection.request.timeout | s3.connection.request.timeout | S3 请求超时时间，单位为毫秒，指定连接 Minio 服务时的请求超时时间 | 3000   | 否       |
 | minio.connection.timeout       | s3.connection.timeout    | S3 连接超时时间，单位为毫秒，指定与 Minio 服务建立连接时的超时时间 | 1000   | 否       |
-| minio.use_path_style           | s3.use_path_style        | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
+| minio.use_path_style           | use_path_style           | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
 
 ### 使用 Path-style 访问
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/s3.md

@@ -63,7 +63,7 @@
 | s3.access_key                 |                                | AWS Access Key。用于身份验证                                         | 无      | 否       |
 | s3.secret_key                 |                                | AWS Secret Key。用于身份验证                                         | 无      | 否       |
 | s3.region                     |                                | S3 所在区域，例如：`us-east-1`。强烈建议配置                         | 无      | 是       |
-| s3.use_path_style             |                                | 是否使用 path-style（路径风格）访问                                  | FALSE   | 否       |
+| use_path_style                | s3.path-style-access            | 是否使用 path-style（路径风格）访问                                  | FALSE   | 否       |
 | s3.connection.maximum         |                                | 最大连接数，适用于高并发场景                                         | 50      | 否       |
 | s3.connection.request.timeout |                                | 请求超时时间（毫秒），控制连接获取超时                               | 3000    | 否       |
 | s3.connection.timeout         |                                | 建立连接的超时时间（毫秒）                                           | 1000    | 否       |
@@ -73,6 +73,8 @@
 
 > 版本说明：`s3.credentials_provider_type` 自 **3.1.4** 和 **4.0.3** 起支持。
 
+> 参数名称说明：开启路径风格访问的参数是 `use_path_style`，它不带 `s3.` 前缀，`s3.use_path_style` 并不是合法参数，设置后不会生效；`s3.path-style-access` 可作为别名使用。使用 S3 兼容对象存储时，也可使用各自前缀的写法，例如 `oss.use_path_style`、`obs.use_path_style`、`minio.use_path_style`、`ozone.use_path_style`。
+
 ## 认证配置
 
 Doris 支持以下三种方式访问 S3：
@@ -191,7 +193,7 @@
 * 普通 bucket：s3.us-east-1.amazonaws.com
 * Directory Bucket：s3express-usw2-az1.us-west-2.amazonaws.com
 
 更多可用区域参考：[AWS 官方文档](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html)
 
 示例：
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/storages/seaweedfs.md

@@ -9,7 +9,7 @@
 
 # SeaweedFS
 
 本文档介绍访问 [SeaweedFS](https://seaweedfs.com/) 所需的参数，这些参数适用于以下场景：
 
 - Catalog 属性
 - Table Valued Function 属性
@@ -30,7 +30,7 @@
 weed mini -dir=/data
 ```
 
 启动后 S3 服务可通过 `http://localhost:8333` 访问，`my-bucket` 已创建，凭证为 `admin` / `secret`。Docker、自定义端口、多桶、反向代理等更多用法请参见 [Quick Start with `weed mini`](https://github.com/seaweedfs/seaweedfs/wiki/Quick-Start-with-weed-mini)。
 
 ## 参数总览
 
@@ -42,14 +42,14 @@
 | s3.access_key                     | 在 SeaweedFS S3 IAM 配置中创建的 Access Key                                                  |        | 是       |
 | s3.secret_key                     | 与 `s3.access_key` 配对使用的 Secret Key                                                     |        | 是       |
 | s3.region                         | 区域。SeaweedFS 不会校验取值，但 AWS S3 SDK 要求必须设置，例如 `us-east-1`                    |        | 是       |
-| s3.use_path_style                 | 建议设置为 `true`。SeaweedFS 通过 `http://<endpoint>/<bucket>/<key>` 形式提供对象访问         | FALSE  | 否       |
+| use_path_style                    | 建议设置为 `true`。SeaweedFS 通过 `http://<endpoint>/<bucket>/<key>` 形式提供对象访问         | FALSE  | 否       |
 | s3.connection.maximum             | 与 SeaweedFS S3 网关之间的最大连接数                                                          | 50     | 否       |
 | s3.connection.request.timeout     | 请求超时时间，单位为毫秒                                                                       | 3000   | 否       |
 | s3.connection.timeout             | 建立连接的超时时间，单位为毫秒                                                                 | 1000   | 否       |
 
 ### 使用 Path-style 访问
 
-SeaweedFS 使用 path-style 地址（`http://<endpoint>/<bucket>/<key>`），不为每个 bucket 分配独立的 DNS 子域名，因此请将 `s3.use_path_style` 设置为 `true`。
+SeaweedFS 使用 path-style 地址（`http://<endpoint>/<bucket>/<key>`），不为每个 bucket 分配独立的 DNS 子域名，因此请将 `use_path_style` 设置为 `true`。
 
 ## 示例配置
 
@@ -58,12 +58,12 @@
 "s3.secret_key" = "your-secret-key",
 "s3.endpoint" = "http://seaweedfs.example.com:8333",
 "s3.region" = "us-east-1",
-"s3.use_path_style" = "true"
+"use_path_style" = "true"
 ```
 
 ## 使用建议
 
-* 将 `s3.use_path_style` 设置为 `true`，SeaweedFS 不使用 per-bucket DNS 子域名。
+* 将 `use_path_style` 设置为 `true`，SeaweedFS 不使用 per-bucket DNS 子域名。
 * `s3.region` 是 AWS S3 SDK 的必填项，SeaweedFS 本身不会校验该值，填入任意非空字符串即可。
 * 如需 HTTPS，可在反向代理上终止 TLS，并使用 `-s3.externalUrl=https://<proxy>` 启动 `weed`，以便 S3 签名校验通过。
 * 如需将 Iceberg 表存储在 SeaweedFS 的 S3 Table Bucket 中，详见 [Integration with SeaweedFS](../best-practices/doris-seaweedfs.md)。

i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/aliyun-oss.md

@@ -27,7 +27,7 @@
 | oss.secret_key                 | s3.secret_key                | OSS Secret Key，与 Access Key 配合使用                       | 无     |
 | oss.session_token              | s3.session_token             | OSS 临时安全令牌（STS Security Token），使用临时访问凭证时与临时 AK/SK 配合使用。自 4.0.6 版本起支持。 | 无     |
 | oss.region                     | s3.region                    | OSS region，指定阿里云 OSS 的区域                             | 无     |
-| oss.use_path_style             | s3.use_path_style            | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  |
+| oss.use_path_style             | use_path_style               | 是否使用 path-style（路径风格）访问。兼容 MinIO 等非 AWS S3 服务建议设置为 true | FALSE  |
 | oss.connection.maximum         | s3.connection.maximum        | 最大连接数，指定与 OSS 服务建立的最大连接数                  | 50     |
 | oss.connection.request.timeout | s3.connection.request.timeout| 请求超时时间（毫秒），指定连接 OSS 服务时的请求超时时间       | 3000   |
 | oss.connection.timeout         | s3.connection.timeout        | 连接超时时间（毫秒），指定与 OSS 服务建立连接时的超时时间     | 1000   |
@@ -38,7 +38,7 @@
 
 ```properties
 "oss.access_key" = "your-access-key",
 "oss.secret_key" = "your-secret-key",
 "oss.endpoint" = "oss-cn-beijing.aliyuncs.com",
 "oss.region" = "cn-beijing"
 ```
@@ -109,7 +109,7 @@
 ```properties
 "fs.oss-hdfs.support" = "true",
 "oss.hdfs.access_key" = "your-access-key",
 "oss.hdfs.secret_key" = "your-secret-key",
 "oss.hdfs.endpoint" = "cn-hangzhou.oss-dls.aliyuncs.com",
 "oss.hdfs.region" = "cn-hangzhou"
 ```

i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/storages/huawei-obs.md

@@ -24,7 +24,7 @@
 | obs.access_key               | s3.access_key            | OBS access key，用于身份验证的 OBS 访问密钥                  |        | 是       |
 | obs.secret_key               | s3.secret_key            | OBS secret key，与 access key 配合使用的访问密钥             |        | 是       |
 | obs.region                   | s3.region                | OBS region，指定华为云 OBS 的区域                            |        | 否       |
-| obs.use_path_style           | s3.use_path_style        | 是否使用 path-style（路径风格）访问。兼容 MinIO/Ceph 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
+| obs.use_path_style           | use_path_style           | 是否使用 path-style（路径风格）访问。兼容 MinIO/Ceph 等非 AWS S3 服务建议设置为 true | FALSE  | 否       |
 | obs.connection.maximum       | s3.connection.maximum    | 最大连接数，指定与 OBS 服务建立的最大连接数                  | 50     | 否       |
 | obs.connection.request.timeout | s3.connection.request.timeout | 请求超时时间，单位为毫秒，指定连接 OBS 服务时的请求超时时间  | 3000   | 否       |
 | obs.connection.timeout       | s3.connection.timeout    | 连接超时时间，单位为毫秒，指定与 OBS 服务建立连接时的超时时间 | 1000   | 否       |