{"id":28566993,"url":"https://github.com/altinity/antalya-examples","last_synced_at":"2025-06-10T15:40:53.244Z","repository":{"id":288167389,"uuid":"930670097","full_name":"Altinity/antalya-examples","owner":"Altinity","description":"Documentation and sample code for Altinity's Antalya branch of ClickHouse®","archived":false,"fork":false,"pushed_at":"2025-05-21T14:52:25.000Z","size":241,"stargazers_count":43,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-21T15:51:39.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Altinity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-11T02:30:22.000Z","updated_at":"2025-05-21T14:52:30.000Z","dependencies_parsed_at":"2025-05-21T15:52:18.319Z","dependency_job_id":null,"html_url":"https://github.com/Altinity/antalya-examples","commit_stats":null,"previous_names":["altinity/antalya-examples"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Altinity%2Fantalya-examples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Altinity%2Fantalya-examples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Altinity%2Fantalya-examples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Altinity%2Fantalya-examples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Altinity","download_url":"https://codeload.github.com/Altinity/antalya-examples/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Altinity%2Fantalya-examples/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259104331,"owners_count":22805857,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-10T15:40:20.372Z","updated_at":"2025-06-10T15:40:53.222Z","avatar_url":"https://github.com/Altinity.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=center\u003e\n\n\u003ca href=\"https://altinity.com/slack\"\u003e\n  \u003cimg src=\"https://img.shields.io/static/v1?logo=slack\u0026logoColor=959DA5\u0026label=Slack\u0026labelColor=333a41\u0026message=join%20conversation\u0026color=3AC358\" alt=\"AltinityDB Slack\" /\u003e\n\u003c/a\u003e\n\n\u003cpicture align=center\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"/docs/images/logo_horizontal_blue_white.png\"\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"/docs/images/logo_horizontal_blue_black.png\"\u003e\n    \u003cimg alt=\"Altinity company logo\" src=\"/docs/images/logo_horizontal_blue_black.png\"\u003e\n\u003c/picture\u003e\n\n\u003c/div\u003e\n\n# Altinity Project Antalya Examples\n\nProject Antalya is a new branch of ClickHouse® code designed to\nintegrate real-time analytic query with data lakes.  This project\nprovides documentation as well as working code examples to help you use\nand contribute to Antalya.\n\n*Important Note!* Altinity maintains and supports Project Antalya. Altinity \nis not affiliated or associated with ClickHouse Inc any way. ClickHouse® is \na registered trademark of ClickHouse, Inc. \n\nSee the \n[Community Support Section](#community-support) if you want to ask \nquestions or log ideas and issues.\n\n## Project Antalya Goals and Roadmap\n\nThe main goals of Antalya are as follows. \n\n* Enable real-time analytics to work off a single copy of\n  data that is shared with AI and data science applications.\n* Provide a single SQL endpoint for native ClickHouse® and data lake data.\n* Use open table formats to enable easy access from any application type.\n* Separate compute and storage; moreover, allow users to scale compute \n  for ingest, merge, transformatino, and query independently. \n\nAntalya will implement these goals through the following concrete features:\n\n1. Optimize query performance of ClickHouse® on Parquet files stored \n   S3-compatible object storage. \n2. Enable ClickHouse® clusters to add pools of stateless servers aka swarm\n   clusters that handle query and insert operations on shared object storage \n   files with linear scaling.\n3. Adapt ClickHouse® to use Iceberg tables as shared storage.\n4. Enable ClickHouse® clusters to extend existing tables onto unlimited\n   Iceberg storage with transparent query across both native MergeTree and\n   Parquet data. \n5. Simplify backup and DR by leveraging Iceberg snapshots.\n6. Maintain full compability with upstream ClickHouse® features and\n   bug fixes.\n\nAt this time Project Antalya builds demonstrate features 1, 2, 3 (partially), and 6. \n\n## Licensing\n\nProject Antalya code is licensed under Apache 2.0 license. There are no feature\nhold-backs.\n\n## Quick Start\n\nSee the [Docker Quick Start](./docker/README.md) to try out Antalya in\na few minutes using Docker Compose on a laptop.\n\n## Scalable Swarm Example\n\nFor a fully functional swarm cluster implemention, look at the\n[kubernetes](kubernetes/README.md) example. It demonstrates use of swarm\nclusters on a large blockchain dataset stored in Parquet.\n\n## Project Antalya Binaries\n\n### Packages\n\nProject Antalya ClickHouse® server and keeper packages are available on the \n[builds.altinity.cloud](https://builds.altinity.cloud/) page. Scan to the last \nsection to find them. \n\n### Containers\n\nProject Antalya ClickHouse® server and ClickHouse® keeper containers are available\non Docker Hub. To start Antalya run the following Docker commands:\n\n```\ndocker run altinity/clickhouse-server:25.2.2.27660.altinityantalya\ndocker run altinity/clickhouse-keeper:25.2.2.27660.altinityantalya\n```\n\nCheck for the latest build on \n[Docker Hub](https://hub.docker.com/r/altinity/clickhouse-server/tags). \n\n## Documentation\n\nLook in the docs directory for current documentation. \n\n* [Project Antalya Concepts Guide](docs/concepts.md) \n* [Project Antalya Feature Status](docs/feature-status.md) \n* [Command and Configuration Reference](docs/reference.md)\n\nSee also the [Project Antalya Launch Video](https://altinity.com/events/scale-clickhouse-queries-infinitely-with-10x-cheaper-storage-introducing-project-antalya) \nfor an introduction to Project Antalya and a demo of performance.\n\n## Code\n\nTo access Project Antalya code run the following commands. \n\n```\ngit clone git@github.com:Altinity/ClickHouse.git Altinity-ClickHouse\ncd Altinity-ClickHouse\ngit branch\n```\n\nYou will be in the antalya branch by default. \n\n## Building\n\nBuild instructions are located [here](https://github.com/Altinity/ClickHouse/blob/antalya/docs/en/development/developer-instruction.md) \nin the Altinity ClickHouse code tree. Project Antalya code does not \nintroduce new libaries or build procedures. \n\n## Contributing\n\nWe welcome contributions. We're setting up procedures for community\ncontribution. For now, please contact us in Slack to find out how to \njoin the project.\n\n## Community Support\n\nJoin the [AltinityDB Slack Workspace](https://altinity.com/slack) or \n[log an issue](https://github.com/Altinity/antalya-examples/issues) to get help. \n\n## Commercial Support\n\nAltinity is the primary maintainer of Project Antalya. It is the basis of our data \nlake-enabled Altinity.Cloud and is also used in self-managed installations. \nAltinity offers a range of services related to ClickHouse® and data lakes. \n\n- [Official website](https://altinity.com/) - Get a high level overview of Altinity and our offerings.\n- [Altinity.Cloud](https://altinity.com/cloud-database/) - Run ClickHouse® in our cloud or yours.\n- [Altinity Support](https://altinity.com/support/) - Get Enterprise-class support for ClickHouse®.\n- [Slack](https://altinity.com/slack) - Talk directly with ClickHouse® users and Altinity devs.\n- [Contact us](https://hubs.la/Q020sH3Z0) - Contact Altinity with your questions or issues.\n- [Free consultation](https://hubs.la/Q020sHkv0) - Get a free consultation with a ClickHouse® expert today.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltinity%2Fantalya-examples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faltinity%2Fantalya-examples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faltinity%2Fantalya-examples/lists"}