npm / @clickhouse/client
@clickhouse/client
What changed in @clickhouse/client 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
6 new APIs and options3 behavior and defaults6 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@clickhouse/client 115 changes
New APIs and options 6
This type is now exported from the package root and can be imported from @clickhouse/client.
This client option defaults to false; when enabled, raw SQL is attached to spans and included in error-level logs for failed requests. Bound query_params values and credentials are never logged or traced.
This type is now exported from the package root and can be imported from @clickhouse/client.
This type is now exported from the package root and can be imported from @clickhouse/client.
This type is now exported from the package root and can be imported from @clickhouse/client.
A per-request query parameter field lets callers add application-level context to operation spans; caller attributes cannot override the client's db.*, server.*, or clickhouse.* attributes.
Behavior and default changes 3
The X-ClickHouse-Summary counters are now attached to the clickhouse.query span, making request-level metrics visible on the outer client span.
Every key in the summary header is recorded as a span attribute, including memory_usage and future server-side additions.
This span attribute is now recorded for non-streaming result consumption, including json() on single-document JSON formats.
Fixes and other changes 6
On Node.js, prevents an orphaned idle-socket timer from destroying a socket during a request that took it over after another queued request was aborted.
Date values nested in arrays, tuples, and maps are now emitted as quoted UTC date strings; nested Array(DateTime) and Array(DateTime64) bindings use day precision, while scalar binding is unchanged.
This type is now exported from the package root and can be imported from @clickhouse/client.
This type is now exported from the package root and can be imported from @clickhouse/client.
Re-exported from @clickhouse/client after being missed when the client-common public API was bundled into the client packages.
Re-exported from @clickhouse/client after being missed when the client-common public API was bundled into the client packages.