This is an automated email from the ASF dual-hosted git repository.
roryqi pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/gravitino.git
The following commit(s) were added to refs/heads/main by this push:
new ae9a52191f [#11077] docs: Document Trino 482 fix for SHOW SCHEMAS on
Gravitino IRC (#11808)
ae9a52191f is described below
commit ae9a52191f1902377aa6304db1af07ccc3462b37
Author: MaSai <[email protected]>
AuthorDate: Mon Jun 29 19:10:30 2026 +0800
[#11077] docs: Document Trino 482 fix for SHOW SCHEMAS on Gravitino IRC
(#11808)
### What changes were proposed in this pull request?
Add a Known Issues entry to `docs/iceberg-rest-engine/trino.md`
describing
`SHOW SCHEMAS` failures when Trino connects to Gravitino IRC with OAuth2
and
nested namespaces enabled, and note that Trino 482+ resolves the issue.
### Why are the changes needed?
Trino 482 includes a fix for excessive OAuth token requests during
recursive
namespace listing on Iceberg REST catalogs. Users hitting this scenario
need
documentation on the affected configuration and the required Trino
version.
Fix: #11077
### Does this PR introduce _any_ user-facing change?
Documentation only. No API or configuration changes.
### How was this patch tested?
./gradlew :docs:build
---------
Co-authored-by: Cursor <[email protected]>
---
docs/iceberg-rest-engine/trino.md | 20 +++++++++++++++-----
1 file changed, 15 insertions(+), 5 deletions(-)
diff --git a/docs/iceberg-rest-engine/trino.md
b/docs/iceberg-rest-engine/trino.md
index 0302314b49..2a438830d6 100755
--- a/docs/iceberg-rest-engine/trino.md
+++ b/docs/iceberg-rest-engine/trino.md
@@ -190,14 +190,24 @@ WITH (
## Known Issues
+### `SHOW SCHEMAS` Fails on Gravitino IRC (OAuth2, Nested Namespaces)
+
+**Cause:** When Trino connects to Gravitino IRC with
`iceberg.rest-catalog.security=OAUTH2`,
+`iceberg.rest-catalog.nested-namespace-enabled=true`, and
`iceberg.rest-catalog.session=NONE`
+(the default), `SHOW SCHEMAS` recursively calls Iceberg REST `listNamespaces`.
On Trino releases
+before 482, each recursive call creates a separate OAuth session, which can
trigger excessive token
+requests and cause errors such as `Connection pool shut down` or
`StackOverflowError`.
+
+**Solution:** Upgrade to Trino 482+.
+
### `TIMESTAMP WITH TIME ZONE` Values Are Not Adjusted to the Client Session
Time Zone
-For `TIMESTAMP WITH TIME ZONE` values, Trino does not adjust query results
according to the client
-session time zone. Unlike Spark and Flink, Trino displays these values based
on the stored
-timestamp-with-time-zone value.
+**Cause:** For `TIMESTAMP WITH TIME ZONE` values, Trino does not adjust query
results according to
+the client session time zone. Unlike Spark and Flink, Trino displays these
values based on the
+stored timestamp-with-time-zone value.
-To convert a `TIMESTAMP WITH TIME ZONE` value to the current client session
time zone, use
-`at_timezone` together with `current_timezone()`:
+**Solution:** To convert a `TIMESTAMP WITH TIME ZONE` value to the current
client session time
+zone, use `at_timezone` together with `current_timezone()`:
```sql
SELECT
