Altinity Project Antalya Builds for ClickHouse® 25.3

Here are the detailed release notes for Altinity Project Antalya build version 25.3. For more details on the project, see:

• The project's README
• The project roadmap
• The feature matrix

Release history

Version 25.3.3.20143 is the latest release. We recommend that you use this version.

v25.3.3.20143

Released 2025-06-13

CI report | Release page

New base upstream release

• As of this release, Project Antalya is based on upstream v25.3.3.42-lts.

Changes compared to Antalya release 25.2.2.28788

New Feature - General

• Add icebergHash and icebergBucketTransform functions. Support data files pruning in Iceberg tables partitioned with bucket transform. (ClickHouse#79262 by @divanik via #786)

New Features - Performance

• Iceberg table pruning in cluster requests (#770 by @ianton-ru)
• ListObjectsV2 cache (#743 by @arthurpassos)
• Improve performance of hive path parsing (#734 by @arthurpassos - released in upstream 25.5.1 via ClickHouse#79067 )
• Lazy metadata loading for DataLake (#742 by @ianton-ru)
• Iceberg metadata files cache (backport of ClickHouse#77156 by @ianton-ru via #733)
• Support MinMax index for Iceberg (backport of ClickHouse#78242 by @ianton-ru via #733)
• Parquet: merge bloom filter and min/max evaluation (#590 by @arthurpassos - released in upstream 25.2.1 via ClickHouse#71383)
• Parquet: Int logical type support on native reader (#589 by @arthurpassos - released in upstream 25.1.1 via ClickHouse#72105)
• Parquet file metadata caching (#586 by @arthurpassos)
• Parquet file metadata caching: clear cache (#713 by @arthurpassos)
• Parquet file metadata caching: use cache for parquetmetadata format (#636 by @arthurpassos)
• Parquet file metadata caching: turn cache on by default (#669 and #674 by @arthurpassos)

New Features - Swarms

• Setting object_storage_max_nodes (#677 by @ianton-ru)
• Rendezvous hashing filesystem cache (#709 by @enmk)
• Convert functions with object_storage_cluster setting to cluster functions (#712 by @ianton-ru)
• Auxiliary autodiscovery (backport of ClickHouse#71911 by @ianton-ru via #531)
• Fix remote call of s3Cluster function (backport of ClickHouse#72625 by @ianton-ru via #583)
• Cluster auto discovery (backport of ClickHouse#76001 by @ianton-ru via #629)
• Alternative syntax for object storage cluster functions (backport of ClickHouse#70659 by @enmk via #592)
• Limit parsing threads for distributed case (#648 by @ianton-ru)
• Distributed request to tables with Object Storage engines (#615 by @ianton-ru)

New Features - Catalogs

• General engine definition for Iceberg tables (#675 by @ianton-ru)
• RBAC for S3 (#688 by @zvonand)

New Features - Tiered Storage

• Better S3 URL parsing for Hive partitioning (#700 by @arthurpassos - released to upstream 25.5.1 via ClickHouse#78185)
• s3Cluster hive partitioning for old analyzer (#703 by @enmk)
• Support partition pruning in DeltaLake engine (backport of ClickHouse#78486 by @ianton-ru via #733)
• Iceberg time travel by snapshots (backport of ClickHouse#77439 by @ianton-ru via #733)
• s3Cluster hive partitioning (#584 by @ianton-ru)

Improvements

• Add several convenient ways to resolve root metadata.json file in an iceberg table function and engine. Closes #78455. (ClickHouse#78475 by @divanik via #841)
• Iceberg as alias for DataLakeCatalog with catalog_type=‘rest’. (#822 by @ianton-ru)

Bug Fix (user-visible misbehavior in an official stable release)

• Fixed Context expiration for Iceberg queries. (#839 by @ianton-ru)

Build/Testing/Packaging Improvement

• Fixed parquet metadata related tests. (#824 by @Enmk)

Packages

• Available for both AMD64 and Aarch64 from builds.altinity.cloud as either .deb, .rpm, or .tgz

Docker images

• Available for both AMD64 and Aarch64: altinity/clickhouse-server:25.3.3.20143.altinityantalya