This is an automated email from the ASF dual-hosted git repository.
kassiez 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 958c9081c1 [opt] Modify storage vault `use_path_style` default
behavior (#1559)
958c9081c1 is described below
commit 958c9081c1adc9e66fc51587b6c26db80658aa53
Author: Lei Zhang <1091517...@qq.com>
AuthorDate: Wed Dec 25 11:45:39 2024 +0800
[opt] Modify storage vault `use_path_style` default behavior (#1559)
* `use_path_style` default vault from `false` to `true`
## Versions
- [x] dev
- [x] 3.0
- [ ] 2.1
- [ ] 2.0
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../Create/CREATE-STORAGE-VAULT.md | 17 +++++++++++------
.../Create/CREATE-STORAGE-VAULT.md | 17 +++++++++++------
.../storage-management/CREATE-STORAGE-VAULT.md | 17 +++++++++++------
.../storage-management/CREATE-STORAGE-VAULT.md | 16 +++++++++++-----
4 files changed, 44 insertions(+), 23 deletions(-)
diff --git
a/docs/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
b/docs/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
index 54b174cec8..f1f5214c74 100644
---
a/docs/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
+++
b/docs/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
@@ -55,7 +55,7 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
| `s3.access_key` | required | The access key of your object storage
account. (AccountName if you're using Azure).
|
| `s3.secret_key` | required | The secret key of your object storage
account. (AccountKey if you're using Azure).
|
| `provider` | required | The cloud vendor which provides the object
storage service. The supported values include `COS`, `OSS`, `S3`, `OBS`, `BOS`,
`AZURE`, `GCP`
|
-| `use_path_style` | optional | Indicate using `path-style` URL or
`virtual-hosted-style URL`, default `false` (`virtual-hosted-style`)
|
+| `use_path_style` | optional | Indicate using `path-style URL`(private
environment recommended) or `virtual-hosted-style URL`(public cloud
recommended), default `true` (`path-style`)
|
##### HDFS Vault
@@ -104,7 +104,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-hangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OSS"
+ "provider" = "OSS",
+ "use_path_style" = "false"
);
```
@@ -119,7 +120,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "ap-guangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "COS"
+ "provider" = "COS",
+ "use_path_style" = "false"
);
```
@@ -134,7 +136,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-north-4",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OBS"
+ "provider" = "OBS",
+ "use_path_style" = "false"
);
```
@@ -149,7 +152,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "false"
);
```
7. create a S3 storage vault using MinIO.
@@ -163,7 +167,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "true"
);
```
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
index 88c5ed8309..3b682945c7 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/Data-Definition-Statements/Create/CREATE-STORAGE-VAULT.md
@@ -54,7 +54,7 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
| `s3.access_key` | 必需 | 您的对象存储账户的访问密钥。(如果您使用 Azure,则为 AccountName)。 |
| `s3.secret_key` | 必需 | 您的对象存储账户的秘密密钥。(如果您使用 Azure,则为 AccountKey)。 |
| `provider` | 必需 |
提供对象存储服务的云供应商。支持的值有`COS`，`OSS`，`S3`，`OBS`，`BOS`，`AZURE`，`GCP` |
-| `use_path_style` | 可选 | 使用 path-style URL 或者 virtual-hosted-style URL, 默认值
false(virtual-hosted-style)
|
+| `use_path_style` | 可选 | 使用 `path-style
URL`(私有化部署环境)或者`virtual-hosted-style URL`(公有云环境建议), 默认值 `true` (path-style)
|
##### HDFS vault
@@ -103,7 +103,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-hangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OSS"
+ "provider" = "OSS",
+ "use_path_style" = "false"
);
```
@@ -118,7 +119,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "ap-guangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "COS"
+ "provider" = "COS",
+ "use_path_style" = "false"
);
```
@@ -133,7 +135,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-north-4",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OBS"
+ "provider" = "OBS",
+ "use_path_style" = "false"
);
```
@@ -148,7 +151,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "false"
);
```
7. 创建 MinIO S3 storage vault。
@@ -162,7 +166,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "true"
);
```
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
index aa8bbf4219..4e55975ccf 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
@@ -54,7 +54,7 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
| `s3.access_key` | 必需 | 您的对象存储账户的访问密钥。(如果您使用 Azure，则为 AccountName)。 |
| `s3.secret_key` | 必需 | 您的对象存储账户的秘密密钥。(如果您使用 Azure，则为 AccountKey)。 |
| `provider` | 必需 |
提供对象存储服务的云供应商。支持的值有`COS`，`OSS`，`S3`，`OBS`，`BOS`，`AZURE`，`GCP` |
-| `use_path_style` | 可选 | 使用 `path-style` URL 或者 `virtual-hosted-style` URL,
默认值 `false` (`virtual-hosted-style`)
|
+| `use_path_style` | 可选 | 使用 `path-style
URL`(私有化部署环境)或者`virtual-hosted-style URL`(公有云环境建议), 默认值 `true` (`path-style`)
|
##### HDFS vault
@@ -103,7 +103,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-hangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OSS"
+ "provider" = "OSS",
+ "use_path_style" = "false"
);
```
@@ -118,7 +119,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "ap-guangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "COS"
+ "provider" = "COS",
+ "use_path_style" = "false"
);
```
@@ -133,7 +135,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-north-4",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OBS"
+ "provider" = "OBS",
+ "use_path_style" = "false"
);
```
@@ -148,7 +151,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "false"
);
```
7. 创建 MinIO S3 storage vault。
@@ -162,7 +166,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "true"
);
```
diff --git
a/versioned_docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
b/versioned_docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
index cb19422240..6fc0e219a3 100644
---
a/versioned_docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
+++
b/versioned_docs/version-3.0/sql-manual/sql-statements/cluster-management/storage-management/CREATE-STORAGE-VAULT.md
@@ -55,6 +55,7 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
| `s3.access_key` | required | The access key of your object storage
account. (AccountName if you're using Azure).
|
| `s3.secret_key` | required | The secret key of your object storage
account. (AccountKey if you're using Azure).
|
| `provider` | required | The cloud vendor which provides the object
storage service. The supported values include `COS`, `OSS`, `S3`, `OBS`, `BOS`,
`AZURE`, `GCP`
|
+| `use_path_style` | optional | Indicate using `path-style URL`(private
environment recommended) or `virtual-hosted-style URL`(public cloud
recommended), default `true` (`path-style`)
|
##### HDFS Vault
@@ -104,7 +105,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-hangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OSS"
+ "provider" = "OSS",
+ "use_path_style" = "false"
);
```
@@ -119,7 +121,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "ap-guangzhou",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "COS"
+ "provider" = "COS",
+ "use_path_style" = "false"
);
```
@@ -134,7 +137,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "cn-north-4",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "OBS"
+ "provider" = "OBS",
+ "use_path_style" = "false"
);
```
@@ -149,7 +153,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "false"
);
```
7. create a S3 storage vault using MinIO.
@@ -163,7 +168,8 @@ CREATE STORAGE VAULT [IF NOT EXISTS] vault
"s3.region" = "us-east-1",
"s3.root.path" = "ssb_sf1_p2_s3",
"s3.bucket" = "doris-build-1308700295",
- "provider" = "S3"
+ "provider" = "S3",
+ "use_path_style" = "true"
);
```
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
