(gravitino) branch branch-0.9 updated: [#7368] docs(iceberg): add document about how to use Gravitino IRC in StarRocks and Doris (#7389)

[fanng]

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

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


The following commit(s) were added to refs/heads/branch-0.9 by this push:
     new ff77058572 [#7368] docs(iceberg): add document about how to use 
Gravitino IRC in StarRocks and Doris (#7389)
ff77058572 is described below

commit ff77058572572aaa47b8467ba7caf375285bec1c
Author: github-actions[bot] 
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Sat Jun 14 08:09:27 2025 +0800

    [#7368] docs(iceberg): add document about how to use Gravitino IRC in 
StarRocks and Doris (#7389)
    
    ### What changes were proposed in this pull request?
    add document about how to use Gravitino IRC in StarRocks and Doris
    
    ### Why are the changes needed?
    
    Fix: #7368
    
    ### Does this PR introduce _any_ user-facing change?
    no
    
    ### How was this patch tested?
    
    setup StarRocks and Doris and Gravitino IRC, test read, write
    operations.
    
    Co-authored-by: FANNG <xiaoj...@datastrato.com>
---
 docs/iceberg-rest-service.md | 60 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)

diff --git a/docs/iceberg-rest-service.md b/docs/iceberg-rest-service.md
index ca1d88ae01..eeb7bf4c94 100644
--- a/docs/iceberg-rest-service.md
+++ b/docs/iceberg-rest-service.md
@@ -439,6 +439,66 @@ DELETE FROM rest.dml.test WHERE id = 2;
 SELECT * FROM test;
 ```
 
+## Exploring the Apache Gravitino Iceberg REST catalog service with Apache 
Doris
+
+### Creating Iceberg catalog in Apache Doris
+
+```
+CREATE CATALOG iceberg PROPERTIES (
+    "uri" = "http://localhost:9001/iceberg/";,
+    "type" = "iceberg",
+    "iceberg.catalog.type" = "rest",
+    "s3.endpoint" = "http://s3.ap-southeast-2.amazonaws.com";,
+    "s3.region" = "ap-southeast-2",
+    "s3.access_key" = "xxx",
+    "s3.secret_key" = "xxx"
+);
+```
+
+### Exploring Apache Iceberg with Apache Doris SQL
+
+```sql
+SWITCH iceberg;
+CREATE DATABASE db;
+USE db;
+CREATE TABLE t(a int);
+INSERT INTO t values(1);
+SELECT * FROM t;
+```
+
+## Exploring the Apache Gravitino Iceberg REST catalog service with StarRocks
+
+### Creating Iceberg catalog in StarRocks
+
+```
+CREATE EXTERNAL CATALOG 'iceberg'
+COMMENT "Gravitino Iceberg REST catalog on MinIO"
+PROPERTIES
+(
+  "type"="iceberg",
+  "iceberg.catalog.type"="rest",
+  "iceberg.catalog.uri"="http://iceberg-rest:9001/iceberg";,
+  "aws.s3.access_key"="admin",
+  "aws.s3.secret_key"="password",
+  "aws.s3.endpoint"="http://minio:9000";,
+  "aws.s3.enable_path_style_access"="true",
+  "client.factory"="com.starrocks.connector.iceberg.IcebergAwsClientFactory"
+);
+```
+
+Please note that, you should set `client.factory` explicitly.
+
+### Exploring Apache Iceberg with StarRocks SQL
+
+```sql
+SET CATALOG iceberg;
+CREATE DATABASE db;
+USE db;
+CREATE TABLE t(a int);
+INSERT INTO t values(1);
+SELECT * FROM t;
+```
+
 ## Docker instructions
 
 You could run Gravitino Iceberg REST server though docker container: