This is an automated email from the ASF dual-hosted git repository.

yiguolei 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 41f21f6a1df Add MS-GLUE Docs (#2595)
41f21f6a1df is described below

commit 41f21f6a1df7898b12090b913f69a79f1ef2d636
Author: Calvin Kirs <[email protected]>
AuthorDate: Fri Jul 4 19:39:05 2025 +0800

    Add MS-GLUE Docs (#2595)
    
    ## Versions
    
    - [x] dev
    - [ ] 3.0
    - [ ] 2.1
    - [ ] 2.0
---
 .../current/lakehouse/metastores/aws-glue.md       | 98 ++++++++++++++++++++--
 1 file changed, 89 insertions(+), 9 deletions(-)

diff --git 
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aws-glue.md
 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aws-glue.md
index b404d6051f0..a6f14f8c4fb 100644
--- 
a/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aws-glue.md
+++ 
b/i18n/zh-CN/docusaurus-plugin-content-docs/current/lakehouse/metastores/aws-glue.md
@@ -5,14 +5,94 @@
 }
 ---
 
-本文档用于介绍通过`CREATE CATALOG`语句连接并访问 AWS Glue 时所支持的参数。
+# 通过 `CREATE CATALOG` 使用 AWS Glue 的参数说明
 
-| 属性名称              | 描述                                                       
   | 默认值  | 是否必须 |
-| ----------------- | 
----------------------------------------------------------- | ---- | ---- |
-| `glue.endpoint`     | AWS Glue 
endpoint。示例:`https://glue.us-east-1.amazonaws.com` | none | 是    |
-| `glue.access_key`  | AWS Glue access key                                     
    | 空    | 是    |
-| `glue.secret_key`  | AWS Glue secret key                                     
    | 空    | 是    |
-| `glue.catalog_id`  |                                                         
    |      | 尚未支持 |
-| `glue.iam_role`    |                                                         
    |      | 尚未支持 |
-| `glue.external_id` |                                                         
    |      | 尚未支持 |
+本文档介绍通过 `CREATE CATALOG` 使用 **AWS Glue Catalog** 访问 **Iceberg 表** 或 **Hive 表** 
时的参数配置。
 
+---
+
+## 一、通用连接参数(适用于 Hive & Iceberg)
+
+以下参数适用于 **Iceberg Glue Catalog** 和 **Hive Glue Catalog**:
+
+| 属性名称           | 描述                                                          
       | 是否必须 | 默认值 |
+|--------------------|----------------------------------------------------------------------|----------|--------|
+| `glue.region`      | AWS Glue 区域,例如:`us-east-1`                              
       | 是       | 无     |
+| `glue.endpoint`    | AWS Glue 
endpoint,例如:`https://glue.us-east-1.amazonaws.com`      | 是       | 无     |
+| `glue.access_key`  | AWS Access Key ID                                       
             | 是       | 空     |
+| `glue.secret_key`  | AWS Secret Access Key                                   
             | 是       | 空     |
+| `glue.catalog_id`  | Glue Catalog ID(尚未支持)                                   
        | 否       |        |
+| `glue.role_arn`    | 用于访问 Glue 的 IAM Role ARN(尚未支持)                          
 | 否       |        |
+| `glue.external_id` | 与 IAM Role 配合使用的 External ID(尚未支持)                      
| 否       |        |
+
+---
+
+## 二、Iceberg 表配置(使用 Glue Catalog)
+
+配置示例:
+
+```sql
+CREATE CATALOG iceberg_glue_catalog WITH (
+  'type' = 'iceberg',
+  'iceberg.catalog.type' = 'glue',
+  'glue.region' = 'us-east-1',
+  'glue.endpoint' = 'https://glue.us-east-1.amazonaws.com',
+  'glue.access_key' = 'YOUR_ACCESS_KEY',
+  'glue.secret_key' = 'YOUR_SECRET_KEY'
+);
+```
+
+---
+
+## 三、Hive 表配置(使用 Glue 作为 HMS)
+
+配置示例:
+
+```sql
+CREATE CATALOG hive_glue_catalog WITH (
+  'type' = 'hms',
+  'hive.metastore.type' = 'glue',
+  'glue.region' = 'us-east-1',
+  'glue.endpoint' = 'https://glue.us-east-1.amazonaws.com',
+  'glue.access_key' = 'YOUR_ACCESS_KEY',
+  'glue.secret_key' = 'YOUR_SECRET_KEY'
+);
+```
+
+---
+
+## 四、Hive Glue Catalog 专属参数
+
+以下配置 **仅适用于 Hive Glue Catalog**,用于控制 Hive 使用 AWS Glue Metastore 客户端的行为。
+
+
+### Glue 客户端缓存参数(**默认关闭**)
+
+Glue 客户端提供元数据缓存(**仅支持 Hive Glue**):
+
+#### - 表缓存(Table Metadata Cache)
+
+| 参数名称                         | 描述                                | 默认值  |
+|----------------------------------|-------------------------------------|---------|
+| `aws.glue.cache.table.enable`    | 是否启用表缓存                      | `false` |
+| `aws.glue.cache.table.size`      | 表缓存的最大条目数                  | `1000`  |
+| `aws.glue.cache.table.ttl-mins`  | 表缓存的存活时间(分钟)           | `30`    |
+
+#### - 数据库缓存(Database Metadata Cache)
+
+| 参数名称                      | 描述                                  | 默认值  |
+|-------------------------------|---------------------------------------|---------|
+| `aws.glue.cache.db.enable`    | 是否启用数据库缓存                   | `false` |
+| `aws.glue.cache.db.size`      | 数据库缓存的最大条目数               | `1000`  |
+| `aws.glue.cache.db.ttl-mins`  | 数据库缓存的存活时间(分钟)        | `30`    |
+
+参考:
+- [GetTable 
API](https://docs.aws.amazon.com/glue/latest/webapi/API_GetTable.html)
+- [GetDatabase 
API](https://docs.aws.amazon.com/glue/latest/webapi/API_GetDatabase.html)
+
+
+## 注意事项
+
+- 如果你使用的是 **Iceberg 表**,只需关注 **通用连接参数**。
+- 如果你使用的是 **Hive 表** 并将 Glue 作为 Hive Metastore,需额外配置 Hive Glue 专属参数。
+- **缓存机制目前仅在 Hive Glue 场景下有效**,Iceberg Glue Catalog 不使用这些参数。


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to