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 b65bd010fd8 [opt](unity) add more example (#3111)
b65bd010fd8 is described below
commit b65bd010fd838dd878c36fb622f5e45aaefa04e2
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Thu Nov 20 22:25:21 2025 +0800
[opt](unity) add more example (#3111)
## Versions
- [x] dev
- [x] 4.x
- [x] 3.x
- [ ] 2.1
## Languages
- [x] Chinese
- [x] English
## Docs Checklist
- [ ] Checked by AI
- [ ] Test Cases Built
---
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
.../best-practices/doris-unity-catalog.md | 30 ++++++++++++++++++++++
6 files changed, 180 insertions(+)
diff --git a/docs/lakehouse/best-practices/doris-unity-catalog.md
b/docs/lakehouse/best-practices/doris-unity-catalog.md
index 4d31751528c..f72c8a1287d 100644
--- a/docs/lakehouse/best-practices/doris-unity-catalog.md
+++ b/docs/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ Click the user avatar in the top right corner, go to the
`Settings` page, and se
### Creating a Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### Accessing the Catalog
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-unity-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-unity-catalog.md
index a4d884f9793..17c5ad896c1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-unity-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ INSERT INTO `my-unity-catalog`.default.iceberg_table
VALUES(1, "jack");
### 创建 Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### 访问 Catalog
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
index a4d884f9793..17c5ad896c1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ INSERT INTO `my-unity-catalog`.default.iceberg_table
VALUES(1, "jack");
### 创建 Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### 访问 Catalog
diff --git
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
index a4d884f9793..17c5ad896c1 100644
---
a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
+++
b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ INSERT INTO `my-unity-catalog`.default.iceberg_table
VALUES(1, "jack");
### 创建 Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### 访问 Catalog
diff --git
a/versioned_docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
b/versioned_docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
index 4d31751528c..f72c8a1287d 100644
--- a/versioned_docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
+++ b/versioned_docs/version-3.x/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ Click the user avatar in the top right corner, go to the
`Settings` page, and se
### Creating a Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### Accessing the Catalog
diff --git
a/versioned_docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
b/versioned_docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
index 4d31751528c..f72c8a1287d 100644
--- a/versioned_docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
+++ b/versioned_docs/version-4.x/lakehouse/best-practices/doris-unity-catalog.md
@@ -73,6 +73,20 @@ Click the user avatar in the top right corner, go to the
`Settings` page, and se
### Creating a Catalog
```sql
+-- Use oath2 credential and vended credentials
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "iceberg.rest.vended-credentials-enabled" = "true"
+);
+
+-- Use PAT and vended credentials
CREATE CATALOG dbx_unity_catalog PROPERTIES (
"uri" =
"https://<dbc-account>.cloud.databricks.com/api/2.1/unity-catalog/iceberg-rest/",
"type" = "iceberg",
@@ -82,6 +96,22 @@ CREATE CATALOG dbx_unity_catalog PROPERTIES (
"iceberg.rest.oauth2.token" = "<token>",
"iceberg.rest.vended-credentials-enabled" = "true"
);
+
+-- Use oath2 credential and static ak/sk for accessing aws s3
+CREATE CATALOG dbx_unity_catalog PROPERTIES (
+ "uri" =
"https://dbc-xx.cloud.databricks.com:443/api/2.1/unity-catalog/iceberg-rest/";,
+ "type" = "iceberg",
+ "warehouse" = "my-unity-catalog",
+ "iceberg.catalog.type" = "rest",
+ "iceberg.rest.security.type" = "oauth2",
+ "iceberg.rest.oauth2.credential" = "clientid:clientsecret",
+ "iceberg.rest.oauth2.server-uri" =
"https://dbc-xx.cloud.databricks.com:443/oidc/v1/token";,
+ "iceberg.rest.oauth2.scope" = "all-apis",
+ "s3.endpoint" = "https://s3.<region>.amazonaws.com",
+ "s3.access_key" = "<ak>",
+ "s3.secret_key" = "<sk>",
+ "s3.region" = "<region>"
+);
```
### Accessing the Catalog
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
