Project Antalya is a new branch of ClickHouse® code designed to integrate real-time analytic query with data lakes. This project provides documentation as well as working code examples to help you use and contribute to Antalya.
Important Note! Altinity maintains and supports Project Antalya. Altinity is not affiliated or associated with ClickHouse Inc any way. ClickHouse® is a registered trademark of ClickHouse, Inc.
See the Community Support Section if you want to ask questions or log ideas and issues.
The main goals of Antalya are as follows.
- Enable real-time analytics to work off a single copy of data that is shared with AI and data science applications.
- Provide a single SQL endpoint for native ClickHouse® and data lake data.
- Use open table formats to enable easy access from any application type.
- Separate compute and storage; moreover, allow users to scale compute for ingest, merge, transformatino, and query independently.
Antalya will implement these goals through the following concrete features:
- Optimize query performance of ClickHouse® on Parquet files stored S3-compatible object storage.
- Enable ClickHouse® clusters to add pools of stateless servers aka swarm clusters that handle query and insert operations on shared object storage files with linear scaling.
- Adapt ClickHouse® to use Iceberg tables as shared storage.
- Enable ClickHouse® clusters to extend existing tables onto unlimited Iceberg storage with transparent query across both native MergeTree and Parquet data.
- Simplify backup and DR by leveraging Iceberg snapshots.
- Maintain full compability with upstream ClickHouse® features and bug fixes.
At this time Project Antalya builds demonstrate features 1, 2, 3 (partially), and 6.
Project Antalya code is licensed under Apache 2.0 license. There are no feature hold-backs.
See the Docker Quick Start to try out Antalya in a few minutes using Docker Compose on a laptop.
For a fully functional swarm cluster implemention, look at the kubernetes example. It demonstrates use of swarm clusters on a large blockchain dataset stored in Parquet.
Project Antalya ClickHouse® server and keeper packages are available on the builds.altinity.cloud page. Scan to the last section to find them.
Project Antalya ClickHouse® server and ClickHouse® keeper containers are available on Docker Hub. To start Antalya run the following Docker commands:
docker run altinity/clickhouse-server:25.2.2.27660.altinityantalya
docker run altinity/clickhouse-keeper:25.2.2.27660.altinityantalya
Check for the latest build on Docker Hub.
Look in the docs directory for current documentation.
See also the Project Antalya Launch Video for an introduction to Project Antalya and a demo of performance.
To access Project Antalya code run the following commands.
git clone [email protected]:Altinity/ClickHouse.git Altinity-ClickHouse
cd Altinity-ClickHouse
git branch
You will be in the antalya branch by default.
Build instructions are located here in the Altinity ClickHouse code tree. Project Antalya code does not introduce new libaries or build procedures.
We welcome contributions. We're setting up procedures for community contribution. For now, please contact us in Slack to find out how to join the project.
Join the AltinityDB Slack Workspace or log an issue to get help.
Altinity is the primary maintainer of Project Antalya. It is the basis of our data lake-enabled Altinity.Cloud and is also used in self-managed installations. Altinity offers a range of services related to ClickHouse® and data lakes.
- Official website - Get a high level overview of Altinity and our offerings.
- Altinity.Cloud - Run ClickHouse® in our cloud or yours.
- Altinity Support - Get Enterprise-class support for ClickHouse®.
- Slack - Talk directly with ClickHouse® users and Altinity devs.
- Contact us - Contact Altinity with your questions or issues.
- Free consultation - Get a free consultation with a ClickHouse® expert today.