(gravitino) branch branch-1.0 updated: [#8789] docs(iceberg): add pyiceberg usage document (#8811)

[fanng]

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

fanng pushed a commit to branch branch-1.0
in repository https://gitbox.apache.org/repos/asf/gravitino.git


The following commit(s) were added to refs/heads/branch-1.0 by this push:
     new 7ecd703839 [#8789] docs(iceberg): add  pyiceberg  usage document 
(#8811)
7ecd703839 is described below

commit 7ecd7038390e43c01c29da50c458b4c116a8f4e5
Author: github-actions[bot] 
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Tue Oct 14 14:53:25 2025 +0800

    [#8789] docs(iceberg): add  pyiceberg  usage document (#8811)
    
    ### What changes were proposed in this pull request?
    
    add pyiceberg usage document
    
    ### Why are the changes needed?
    
    Fix: #8789
    
    ### Does this PR introduce _any_ user-facing change?
    
    no
    
    ### How was this patch tested?
    just document
    
    Co-authored-by: FANNG <xiaoj...@datastrato.com>
---
 docs/iceberg-rest-service.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/docs/iceberg-rest-service.md b/docs/iceberg-rest-service.md
index d82f10e5b3..04e10625f7 100644
--- a/docs/iceberg-rest-service.md
+++ b/docs/iceberg-rest-service.md
@@ -576,6 +576,26 @@ INSERT INTO t values(1);
 SELECT * FROM t;
 ```
 
+### Exploring Apache Iceberg with PyIceberg
+
+```python
+from pyiceberg.catalog import load_catalog
+
+catalog = load_catalog(
+    "my_rest_catalog", 
+    **{
+        "type": "rest",
+        "uri": "http://localhost:9001/iceberg";,
+        "header.X-Iceberg-Access-Delegation":"vended-credentials",
+        "auth": {"type": "noop"},
+    }
+)
+
+table_identifier = "db.table"
+table = catalog.load_table(table_identifier)
+print(table.scan().to_arrow())
+```
+
 ## Docker instructions
 
 You could run Gravitino Iceberg REST server though docker container: