Skip to content

v1.8.0rc1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@joe-clickhouse joe-clickhouse released this 12 Aug 21:11
v1.8.0rc1
1513396

clickhouse-connect v1.8.0rc1

This is a release candidate for testing the new optional Rust codec. Please try it and report any issues. Install it with a pinned version:

pip install "clickhouse-connect[rust]==1.8.0rc1"

Highlights

Experimental Rust native codec

This release adds an experimental native_codec client option that selects the codec used for FORMAT Native query decode and insert encode.

  • python is the default and uses the existing codec, so nothing changes unless you opt in.
  • rust prefers the compiled Rust codec and falls back to the Python codec for unsupported options and types (which should be (hopefully) rare).
  • rust_strict raises instead of falling back and is the recommended mode for testing.

The compiled codec is published as the separate clickhouse-connect-core wheel, installed automatically by the [rust] extra. Wheels cover CPython 3.10 through 3.14 on Linux x86_64 and aarch64 for glibc 2.28 and newer plus musl, macOS, and Windows x64 and arm64. Results and dtypes match the Python codec, and the Arrow methods are unaffected.

To enable it on a client:

client = clickhouse_connect.get_client(host=..., native_codec="rust")

This is early access for benchmarking and testing. See the rust-codec documentation page for details.

Also included

Everything in the 1.7.0 and 1.7.1 stable releases.

Installation

For this release candidate: pip install "clickhouse-connect[rust]==1.8.0rc1"

For the latest stable release: pip install clickhouse-connect

Assets 2
Loading