Skip to content

Add FAST session version exchange to SEA client - #1638

Closed
aakash-saravanan-db wants to merge 1 commit into
databricks:mainfrom
aakash-saravanan-db:fast-path-client-tokens-session-versioning
Closed

Add FAST session version exchange to SEA client#1638
aakash-saravanan-db wants to merge 1 commit into
databricks:mainfrom
aakash-saravanan-db:fast-path-client-tokens-session-versioning

Conversation

@aakash-saravanan-db

Copy link
Copy Markdown
Collaborator

Description

Add the SEA client-token/session-version contract required for Fast Path explicit sessions:

  • Create SEA sessions with execution_mode=FAST and seed session-local state from CreateSessionResponse.session_version.version_id.
  • Send the highest observed session version on every execute and fold versions from execute, polling, result, and heartbeat responses.
  • Guard updates by session identity and exclude reattached statement IDs so delayed or foreign responses cannot contaminate the current session.
  • Validate FAST create responses and best-effort delete a created server session when its initial version is missing.

Thrift behavior is unchanged.

Testing

  • mvn -q -DskipTests compile
  • mvn -q spotless:check
  • mvn -q -pl jdbc-core -Dtest=DatabricksSessionTest,DatabricksSdkClientTest,DatabricksStatementTest,DatabricksResultSetTest test
  • Full databricks-jdbc-core local-profile test suite

Additional Notes to the Reviewer

The implementation tracks the maximum version because statement completions may be observed out of order. Live endpoint validation remains pending availability of a Fast Path-capable SEA endpoint.

Signed-off-by: Aakash Saravanan <aakash.saravanan@databricks.com>
@aakash-saravanan-db
aakash-saravanan-db force-pushed the fast-path-client-tokens-session-versioning branch from 98e14a6 to e9ed46e Compare August 14, 2026 18:54
@aakash-saravanan-db

Copy link
Copy Markdown
Collaborator Author

Superseded by #1639, which uses the same commit from an upstream repository branch so same-repository CI credentials and check permissions apply.

@aakash-saravanan-db
aakash-saravanan-db deleted the fast-path-client-tokens-session-versioning branch August 14, 2026 20:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant