This is an automated email from the ASF dual-hosted git repository.
diqiu50 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 ce7ef65508 [#11125] [#10928] docs(trino): Document Trino case-only
object name limitation (#11126)
ce7ef65508 is described below
commit ce7ef6550851d33cebf11a899c51165619240674
Author: MaSai <[email protected]>
AuthorDate: Fri May 22 10:10:29 2026 +0800
[#11125] [#10928] docs(trino): Document Trino case-only object name
limitation (#11126)
### What changes were proposed in this pull request?
This PR adds a `Known issues` section to
`docs/iceberg-rest-engine/trino.md` to document that Trino does not
reliably distinguish metadata names that differ only by letter case. It
also recommends using lowercase metadata names and avoiding objects
whose names differ only by letter case for better compatibility.
### Why are the changes needed?
This makes the current Trino limitation explicit in the Trino Iceberg
REST guide, clarifies that the behavior comes from Trino rather than
Gravitino, and helps users avoid unexpected naming conflicts when using
Trino with the Iceberg REST catalog.
Fix: #11125
Fix: #10928
### Does this PR introduce _any_ user-facing change?
Yes. The Trino Iceberg REST guide now includes a `Known issues` note
about case-only metadata names and recommendations for better
compatibility.
### How was this patch tested?
Not applicable. This is a documentation-only change.
---------
Co-authored-by: Copilot <[email protected]>
---
docs/iceberg-rest-engine/trino.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/docs/iceberg-rest-engine/trino.md
b/docs/iceberg-rest-engine/trino.md
index aeef7425a1..e4c2820ac7 100755
--- a/docs/iceberg-rest-engine/trino.md
+++ b/docs/iceberg-rest-engine/trino.md
@@ -185,6 +185,20 @@ FROM <catalog>.<namespace>.<table>;
| Supported engines | Trino, Spark, Flink, Daft | Any
Iceberg-compatible engine |
| Credential vending | Varies | Yes (S3, GCS, OSS,
ADLS) |
+## Known issues
+
+### Trino identifiers are not treated as case sensitive
+
+Trino identifiers are not treated as case sensitive. As a result, metadata
names that differ
+only by letter case cannot be distinguished. See [Trino identifier
+documentation](https://trino.io/docs/current/language/reserved.html#language-identifiers).
This
+limitation comes from Trino itself and is not specific to Gravitino.
+
+For the best compatibility with Trino:
+
+- Use lowercase metadata names.
+- Avoid creating objects whose names differ only by letter case.
+
## Related
- [Iceberg REST catalog service](../iceberg-rest-service.md)
