Skip to content

Session locked retry - #93

Closed
awitten1 wants to merge 4 commits into
ClickHouse:mainfrom
awitten1:session-locked-retry
Closed

awitten1 wants to merge 4 commits into
ClickHouse:mainfrom
awitten1:session-locked-retry

Conversation

@awitten1

Copy link
Copy Markdown

Summary

A short description of the changes with a link to an open issue.

Checklist

Delete items not relevant to your PR:

  • Unit and integration tests covering the common scenarios were added
  • A human-readable description of the changes was provided so that we can include it in CHANGELOG later
  • For significant changes, documentation in README and https://github.com/ClickHouse/clickhouse-docs was updated with further explanations or tutorials

awitten1 and others added 4 commits November 12, 2026 16:09
Add a database option to choose the transport compression used between the
driver and ClickHouse: "lz4" (the default, unchanged) or "none". ClickHouse
compresses a query's response on a single thread, which can cap one query's
throughput far below what a fast network carries; "none" removes that cap.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Return the result schema of a query without running it, by sending
DESCRIBE (<query>) and mapping the columns with the same type mapping as
Connection::get_table_schema(). Bound parameters are sent with the DESCRIBE.

The schema requests get their own query IDs: the statement's query ID is
reused by its data query, and ClickHouse rejects a request whose query ID is
still held by an earlier request that is being cleaned up. The settings query
starts only after DESCRIBE has finished, because both carry the connection's
session ID and ClickHouse rejects overlapping requests on one session.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ClickHouse 26.2 added output_format_arrow_date_as_uint16, default 0, and now
writes Date columns as Arrow date32 in ArrowStream. The declared schema still
said UInt16, so get_table_schema() and execute_schema() disagreed with the data
execute() returns. Read the setting with the other Arrow format settings and map
Date to Date32 unless it is 1. Servers without the setting (26.1 and older)
always write UInt16, so a missing setting keeps the old mapping.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A connection's requests share one ClickHouse session, and ClickHouse runs one
request at a time per session. When a result set is dropped before it is fully
read, the server is still finishing that query, so the next query on the same
connection failed with SESSION_IS_LOCKED (code 373) every time.

The error arrives before any data, so retry execute() and execute_schema() for
up to about five seconds (5 ms doubling to 200 ms). A bind given as a stream
cannot be replayed, so those requests are not retried. In the new regression
test the follow-up query succeeds after 30-40 ms.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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