This is an automated email from the ASF dual-hosted git repository.
kevinjqliu pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iceberg-python.git
The following commit(s) were added to refs/heads/main by this push:
new 2064a90f [#2624] docs: add gravitino REST catalog use example (#2625)
2064a90f is described below
commit 2064a90f901737f66f76bc0975ab09b1e3acc3ff
Author: FANNG <[email protected]>
AuthorDate: Wed Oct 15 00:16:17 2025 +0900
[#2624] docs: add gravitino REST catalog use example (#2625)
<!--
Thanks for opening a pull request!
-->
<!-- In the case this PR will resolve an issue, please replace
${GITHUB_ISSUE_ID} below with the actual Github issue id. -->
<!-- Closes #2624 -->
# Rationale for this change
Closes #2624
## Are these changes tested?
Yes, test pyIceberg with Gravitino Iceberg REST server
## Are there any user-facing changes?
No
<!-- In the case of user-facing changes, please add the changelog label.
-->
---
mkdocs/docs/configuration.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/mkdocs/docs/configuration.md b/mkdocs/docs/configuration.md
index 9ef4a1f4..3eb6869d 100644
--- a/mkdocs/docs/configuration.md
+++ b/mkdocs/docs/configuration.md
@@ -539,6 +539,18 @@ catalog:
py-io-impl: pyiceberg.io.fsspec.FsspecFileIO
```
+##### Apache Gravitino
+
+```yaml
+catalog:
+ gravitino_catalog:
+ type: rest
+ uri: <gravitino-catalog-uri>
+ header.X-Iceberg-Access-Delegation: vended-credentials
+ auth:
+ type: noop
+```
+
### SQL Catalog
The SQL catalog requires a database for its backend. PyIceberg supports
PostgreSQL and SQLite through psycopg2. The database connection has to be
configured using the `uri` property. The init_catalog_tables is optional and
defaults to True. If it is set to False, the catalog tables will not be created
when the SQLCatalog is initialized. See SQLAlchemy's [documentation for URL
format](https://docs.sqlalchemy.org/en/20/core/engines.html#backend-specific-urls):
