[Tech] Python - Bump clickhouse-connect from 0.15.1 to 1.0.0 in /pipeline

[dependabot]

Bumps clickhouse-connect from 0.15.1 to 1.0.0.

Release notes

Sourced from clickhouse-connect's releases.

v1.0.0

clickhouse-connect 1.0.0

The first stable release of clickhouse-connect. 1.0.0 is identical in code to 1.0.0rc3. No changes have been merged since that tag.

Installation:

pip install clickhouse-connect

Upgrading from 0.x

The 1.0 release includes breaking changes accumulated across the rc1/rc2/rc3 cycle. If you are upgrading from a 0.15.x or earlier release, please read MIGRATION.md for a guide to the changes and their replacements.

At a glance, the breaking changes are:

• Python 3.10 minimum (3.9 dropped. 0.15.x is the last series supporting 3.9)
• pandas 2.0 minimum (1.x dropped)
• pytz dependency replaced with stdlib zoneinfo (install the tzdata extra on slim Linux containers)
• utc_tz_aware -> tz_mode ("naive_utc" / "aware" / "schema")
• apply_server_timezone -> tz_source ("auto" / "server" / "local")
• preserve_pandas_datetime_resolution setting removed: DateTime/DateTime64 now return their natural numpy resolution
• Executor-based async client removed: use clickhouse_connect.get_async_client() (native aiohttp, installed via the async extra)

Highlights

Performance

1.0 includes substantial Cython read- and write-path improvements over the 0.15.x series:

• Order-of-magnitude faster DateTime/DateTime64 reads for naive UTC and UTC-equivalent timezones, via epoch arithmetic and the CPython datetime C API.
• Order-of-magnitude faster fixed-width numeric inserts from numpy arrays, with significantly lower peak memory, 1-D C-contiguous arrays of matching dtype are now copied directly via memcpy.
• Significantly faster Map reads and writes, with reads avoiding the intermediate pair-tuple materialization.
• Significantly faster Decimal and BigDecimal reads, the decode path now builds values directly from the integer column via Decimal.scaleb instead of constructing intermediate strings per row.

Bug fixes

Notable fixes that shipped during the RC cycle:

• Fix intermittent Code: 62. Empty query. (SYNTAX_ERROR) on inserts when a pooled keep-alive connection is reset between attempts. (#731)
• Async client: retry once when aiohttp raises bare ServerDisconnectedError("Server disconnected") on a pooled keep-alive connection idle-closed by the server.
• Fix Dynamic/JSON column reads when a path's inferred type sorts alphabetically after "SharedVariant". (#712)
• Fix async streaming race condition that caused unhandled InvalidStateError on early stream termination.
• SQLAlchemy: wrap raw SQL strings in text() in Inspector.get_schema_names() / get_table_names() so they work on SQLAlchemy 2.x.
• SQLAlchemy: Bool type now accepts and forwards **kwargs, fixing ORM model use and Table.to_metadata(). (#705)
• SQLAlchemy: CreateDatabase with engine="Replicated" now emits valid DDL.

Other improvements

• Package version is now exposed as clickhouse_connect.__version__, following Python packaging conventions.

... (truncated)

Changelog

Sourced from clickhouse-connect's changelog.

1.0.0, 2026-05-13

No code changes since 1.0.0rc3. See the 1.0.0rc1, 1.0.0rc2, and 1.0.0rc3 entries below for the full set of changes included in the 1.0.0 release.

Upgrading from a 0.15.x or earlier release? See https://github.com/ClickHouse/clickhouse-connect/blob/main/MIGRATION.md for a guide to the breaking changes and their replacements.

1.0.0rc3, 2026-05-07

Bug Fixes

• Fix intermittent Code: 62. Empty query. (SYNTAX_ERROR) on inserts when a pooled keep-alive connection is reset between attempts. The retry path now rebuilds the insert body instead of replaying an already-drained generator. Affects both sync and async clients. Closes #731

1.1.0a1, 2026-05-06

This is an alpha preview of the upcoming 1.1.0 release, published from the alembic integration branch for early testing. It includes everything in 1.0.0rc2 plus the items below. The new SQLAlchemy and Alembic APIs introduced here may change before 1.1.0 final.

Improvements

• SQLAlchemy: Alembic migration support. Full Alembic integration for ClickHouse schema migrations: autogeneration of migration scripts from SQLAlchemy metadata, upgrade/downgrade lifecycle, and round-tripping of ClickHouse-specific DDL. Supported operations include create/drop table, add/alter/drop/rename column, type and nullability changes, defaults, comments, IF EXISTS guards, column placement with AFTER, and operation-level clickhouse_settings. ClickHouse table engines (MergeTree, ReplacingMergeTree, etc.) and dictionaries are preserved through the migration lifecycle. Install via pip install clickhouse-connect[alembic]. See clickhouse_connect/cc_sqlalchemy/alembic/WORKED_EXAMPLE.md for an end-to-end walkthrough.
• SQLAlchemy: ClickHouse Dictionary type support. Reflect, create, and drop ClickHouse dictionaries through SQLAlchemy and Alembic.
• SQLAlchemy: PREWHERE, LIMIT BY, and lambda expressions are now available as chainable Select constructs for ClickHouse-specific query shapes.
• SQLAlchemy: Multi-column ARRAY JOIN label preservation. ARRAY JOIN aliases now survive through compilation, fixing label-loss issues with parallel array expansion.
• SQLAlchemy: Migration shim for clickhouse-sqlalchemy users. New cc_sqlalchemy.types and cc_sqlalchemy.engines import-compatible modules ease migration from clickhouse-sqlalchemy. See clickhouse_connect/cc_sqlalchemy/MIGRATING_FROM_CLICKHOUSE_SQLALCHEMY.md.
• SQLAlchemy 1.4 and 2.x compatibility improvements across the dialect and DDL compiler paths.
• Inspector: cloud quirk reflection fixes for ClickHouse Cloud-specific schema reflection edge cases.
• DDL compiler improvements including better handling of nested container types and Tuple adaptation.

Bug Fixes

• Fix Alembic autogenerated migrations rendering enum types (including nested container types) with the correct ClickHouse-compatible representation.

1.0.0rc2, 2026-05-05

Improvements

• Order-of-magnitude faster DateTime and DateTime64 reads for naive UTC and UTC-equivalent timezones. The Cython read paths now decode via epoch arithmetic and construct datetime objects directly via the CPython datetime C API, bypassing datetime.fromtimestamp and the Python-level datetime(...) constructor. Also fixes Cython DateTime conversion bugs and expands epoch-arithmetic test coverage.
• Significantly faster Map reads and writes. The read path avoids materializing an intermediate pair tuple, with the win scaling with entries per row. The write path moves into a new Cython build_map_columns helper.
• Order-of-magnitude faster fixed-width numeric inserts from numpy arrays, with significantly lower peak memory. A new Cython write_native_col helper writes 1-D C-contiguous numpy arrays of matching dtype directly into the output buffer via memcpy, avoiding the per-element conversion the previous path required.
• Significantly faster Decimal and BigDecimal reads. The decode path no longer constructs intermediate strings per row, building values directly from the integer column via Decimal.scaleb.

Bug Fixes

• Async client: retry once when a pooled keep-alive connection is closed by the server and aiohttp raises ServerDisconnectedError with the default "Server disconnected" message. The existing retry path covered "Connection reset" and "Remote end closed", but not the bare ServerDisconnectedError() produced by recent aiohttp versions, which surfaced as an OperationalError("Network Error: Server disconnected") on the first request after an idle period.
• SQLAlchemy Bool type now accepts and forwards **kwargs to the underlying SqlaBoolean constructor. SQLAlchemy's SchemaType machinery passes internal kwargs (e.g., _create_events) when copying or adapting the type during ORM model use or Table.to_metadata(), which previously raised a TypeError. Fixes #705
• SQLAlchemy: CreateDatabase with engine="Replicated" now emits a closing ) after the (zoo_path, shard, replica) arguments, fixing previously invalid DDL on this path. The same arguments and the system.tables lookup in get_engine now go through bound parameters and the existing format_str helper instead of raw f-string interpolation.

1.0.0rc1, 2026-04-22

Breaking Changes

• Dropped the pytz dependency in favor of the standard library zoneinfo. On Windows, tzdata is pulled in automatically. On slim Linux containers without a system tzdb, install pip install clickhouse-connect[tzdata].
• Unknown timezone strings from query_tz, column_tzs, or the server now surface zoneinfo.ZoneInfoNotFoundError internally (previously pytz.exceptions.UnknownTimeZoneError). User-visible ProgrammingError/log messages suggest the tzdata extra. Closes #714.
• Remove the legacy executor-based async client. The AsyncClient(client=...) constructor pattern, executor_threads, and executor parameters are no longer supported. Use clickhouse_connect.get_async_client() (or create_async_client()) which creates a native aiohttp-based async client directly. The pool_mgr parameter is also rejected on the async path. aiohttp remains an optional dependency, installed via pip install clickhouse-connect[async].
• The internal AiohttpAsyncClient class has been renamed to AsyncClient and the module clickhouse_connect.driver.aiohttp_client has been removed. Import AsyncClient from clickhouse_connect.driver as before.
• Removed the deprecated utc_tz_aware parameter entirely. Use tz_mode instead: "naive_utc" (default, was False), "aware" (was True), or "schema" (unchanged). Closes #654, #665
• Removed the deprecated apply_server_timezone parameter entirely. Use tz_source instead: "auto" (default), "server" (was True), or "local" (was False).

... (truncated)

Commits

• eb24221 1.0.0 release prep and migration guide (#738)
• c295aa2 1.0.0rc3 release prep (#733)
• 5703b24 rebuild body on connection-reset insert retry (#732)
• dfb53fd 1.0.0rc2 release prep (#729)
• 39ca7ed Performance improvements (#710)
• f0cedf7 use bound params and format_str in DDL/inspector (#728)
• 95f4c96 Use SPDX license identifier (#727)
• da0ee99 update server ref agent docs, add server map (#724)
• 5b6f3dc fix: accept **kwargs in Bool.init for SQLAlchemy type compatibility (#706)
• 4d2dffa async client: retry on bare ServerDisconnectedError (#726)
• Additional commits viewable in compare view

You can trigger a rebase of this PR by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)

Note
Automatic rebases have been disabled on this pull request as it has been open for over 30 days.

[tristanrobert]

✅ Snyk checks have passed. No issues have been found so far.

Status	Scan Engine	Critical	High	Medium	Low	Total (0)
✅	Open Source Security	0	0	0	0	0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud