Skip to content

ADH-8891 # arrow flight sql integration - #26

Open
nryanov wants to merge 11 commits into
arenadata:develop/4.3.0/1.11.1.1from
nryanov:ADH-8891
Open

ADH-8891 # arrow flight sql integration#26
nryanov wants to merge 11 commits into
arenadata:develop/4.3.0/1.11.1.1from
nryanov:ADH-8891

Conversation

@nryanov

@nryanov nryanov commented Jul 27, 2026

Copy link
Copy Markdown

Why are the changes needed?

This change adds an experimental Arrow Flight SQL frontend so clients can run SQL and metadata operations through Kyuubi while reusing the existing session/engine lifecycle (Spark, Trino, Hive, JDBC, etc.). The producer is a transport adapter only: it calls BackendService and does not invoke engine APIs directly.
Main capabilities:

  • Enable via kyuubi.frontend.protocols=FLIGHT_SQL and configure with canonical kyuubi.frontend.flight.sql.* keys (default bind port 10299).
  • Accept deprecated kyuubi.flight.sql.* aliases when canonical keys are unset (ADCM mapping documented).
  • Statement queries, catalogs/schemas/tables/table-types/type info, Arrow IPC streaming with bounded page fetch, cancellation/cleanup.
  • Auth: NONE, Basic/LDAP, Kerberos SPNEGO bootstrap with short-lived bearer tokens; TLS via PEM (optional keystore→PEM materialization).
  • HA: dedicated discovery namespace (kyuubi.ha.flight.sql.namespace), advertised Flight endpoint, node-affine tickets (no transparent mid-query failover).
  • Flight-specific metrics and monitoring/docs for ADM integration.

Out of scope / intentional limits:

  • Not end-to-end zero-copy past the existing BackendService Thrift/TRowSet Arrow boundary.
  • Explicit unsupported Flight SQL paths (ingest, Substrait, transactions, full prepared-statement binding) return unimplemented status.

How was this patch tested?

  • Unit/integration tests under kyuubi-server:
    • KyuubiFlightSqlFrontendServiceSuite (lifecycle / protocol enablement)
    • KyuubiFlightSqlQuerySuite (execute + Arrow stream via Java FlightSqlClient)
    • KyuubiFlightAuthHandlerSuite
    • KyuubiFlightArrowUtilsSuite
  • Shared harness: WithFlightSqlServer
  • Scala style / settings doc regeneration as part of the branch CI fixes
  • Manual / local

@nryanov
nryanov marked this pull request as ready for review July 30, 2026 01:41
@werzerbb
werzerbb self-requested a review August 5, 2026 10:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants