apache / apache/gravitino

[Improvement] Document that only SQL/TRINO functions are exposed through the Trino connector

Closed
#13,140 0 comments 0 reactions 0 assignees View on GitHub
improvement
Dominant language
Java
Stars
3.2k
Forks
935
Avg merge
1d 16h
Merged PRs (30d)
298

Description

### What would you like to be improved?

A function registered with any language/runtime other than SQL/TRINO (e.g. a Python or Java implementation with runtime SPARK) is silently absent from the Trino connector: it does not appear in `SHOW FUNCTIONS`, and calling it returns a bare `Function ".." not registered` error. Nothing in the product tells the user the function was filtered rather than missing.

The filter in `GravitinoMetadata.isTrinoSqlImplementation` is intentional; the problem is that it is invisible.

### How should we improve?

- State the boundary in the Trino connector docs and the function docs: only functions with language `SQL` and runtime `TRINO` are visible to and callable from Trino; other implementations are managed in Gravitino but not exposed through this connector.
- Show per implementation in the web UI function detail view whether it is exposed through the Trino connector.

A follow-up could surface non-Trino functions and fail invocation with a message naming the registered runtime, but that is connector work with its own risk.

Contributor guide

Open the contributing guide

Research direction

Start with GravitinoMetadata.isTrinoSqlImplementation and locate the Trino connector docs, function docs, and web UI function detail view. Document that only SQL/TRINO implementations are exposed, and make the UI indicate exposure per implementation. Confirm the documentation and UI clearly distinguish managed non-Trino implementations from callable Trino functions.

Written by the indexing model from the issue text.

Assessment

Tech stack
java, sql
Domain
backend, documentation, frontend
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.