Project Antalya

In a nutshell, Project Antalya integrates open-source ClickHouse® and data lakes to lower costs, simplify scaling, and reduce operational complexity in real-time analytic applications. It is 100% compatible with upstream ClickHouse, and many Antalya features have been submitted as PRs.

Key Challenges of Analytics Systems

The project was designed to solve major challenges facing analytics workloads today:

• Soaring Storage Costs - Block storage with replication is 10x more expensive than object storage.
  
  
  • Antalya adds the option to work with data lakes hosted on inexpensive, S3-compatible storage in addition to existing MergeTree storage.
    
    
• Inefficient Use of Compute - Overprovisioning to ingest data and run queries in single processes wastes compute resources.
  
  
  • Antalya’s swarm clusters are clusters of stateless ClickHouse servers that eliminate the need to overprovision compute nodes.
    
    
• Complex Operations - Large clusters of stateful servers scale slowly and are hard to manage.
  
  
  • Antalya’s swarm clusters manage themselves and scale up or down quickly.

Real-Time Data Lakes with Project Antalya

Project Antalya extends open source ClickHouse to bring the power of real-time query to the low cost and outstanding scalability of Apache Iceberg-based data lakes.

• Boost I/O and caching of Parquet to match MergeTree performance
• Deliver sub-second query on data lakes with stateless, cheap swarm clusters
• Archive MergeTree data automatically to Iceberg data (in development; see the project roadmap for details)
• Integrate popular cloud services such as AWS Glue Data Catalogs and AWS S3 Table Buckets.

Status - Roadmap and Release Notes

👉 As of August, 2025, Project Antalya is not for production use.

You can find the project roadmap in the Antalya branch of Altinity's ClickHouse repo.

The latest release is version 25.3.3.20186. See the release notes page for the details of the release, including differences between the latest Project Antalya release and upstream ClickHouse.

The details

The following pages explain the concepts behind Project Antalya, as well as the configuration settings to enable them and the SQL syntax to access them: