Skip to content

Commit 02c3ebf

Browse files
Update Iceberg catalog docs for Glue example (#815)
* Update Iceberg catalog docs for Glue example * clarify
1 parent afe3ca8 commit 02c3ebf

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

website/docs/components/catalogs/iceberg.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,20 @@ catalogs:
3434
iceberg_s3_role_arn: arn:aws:iam::123456789012:role/my-role # Optional. ARN of the IAM role to assume when accessing the S3-compatible endpoint.
3535
iceberg_s3_role_session_name: my-session # Optional. Session name to use when assuming the IAM role.
3636
iceberg_s3_connect_timeout: 60 # Optional. Connection timeout for the S3-compatible endpoint (default: 60).
37+
38+
# AWS Glue Catalog
39+
- from: iceberg:https://glue.us-east-1.amazonaws.com/iceberg/v1/catalogs/123456789012/namespaces
40+
name: glue
41+
params:
42+
iceberg_sigv4_enabled: true
3743
```
3844
3945
## `from`
4046

4147
The `from` field is used to specify the catalog provider. For Iceberg, use `iceberg:<namespace_path>`. The `namespace_path` is the URL to the Iceberg namespace in the catalog provider to load the tables from. It is formatted as `http[s]://<iceberg_catalog_host>/v1/{prefix}/namespaces/<namespace_name>`.
4248

49+
For AWS Glue catalogs, the URL format is `https://glue.<region>.amazonaws.com/iceberg/v1/catalogs/<account_id>/namespaces`, where `<account_id>` is your AWS account ID.
50+
4351
The selected namespace must have sub-namespaces where the tables are stored.
4452

4553
Example: With this Iceberg catalog structure:
@@ -98,6 +106,9 @@ The following parameters are supported for configuring the connection to the Ice
98106
| `iceberg_s3_role_arn` | ARN of the IAM role to assume when accessing the S3-compatible endpoint. |
99107
| `iceberg_s3_role_session_name` | Session name to use when assuming the IAM role. |
100108
| `iceberg_s3_connect_timeout` | Connection timeout in seconds for the S3-compatible endpoint. Default: `60` |
109+
| `iceberg_sigv4_enabled` | Enable SigV4 (AWS Signature Version 4) authentication when connecting to the catalog. Automatically enabled if the URL in `from` is an AWS Glue catalog. Default: `false` |
110+
| `iceberg_signing_region` | Region to use for SigV4 authentication. Extracted from the URL in `from` if not specified. |
111+
| `iceberg_signing_name` | Service name to use for SigV4 authentication. Default: `glue`. |
101112

102113
## Cookbook
103114

0 commit comments

Comments
 (0)