https://github.com/altinity/ice
A suite of tools aimed at making Iceberg REST Catalogs more approachable
https://github.com/altinity/ice
clickhouse iceberg
Last synced: 4 months ago
JSON representation
A suite of tools aimed at making Iceberg REST Catalogs more approachable
- Host: GitHub
- URL: https://github.com/altinity/ice
- Owner: Altinity
- License: apache-2.0
- Created: 2025-04-10T04:41:51.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-06-05T14:53:31.000Z (4 months ago)
- Last Synced: 2025-06-05T15:34:06.257Z (4 months ago)
- Topics: clickhouse, iceberg
- Language: Java
- Homepage: https://altinity.com
- Size: 439 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ice [](https://github.com/altinity/ice/actions/workflows/verify.yaml) []()
A suite of tools aimed at making [Iceberg](https://iceberg.apache.org/) REST Catalogs more approachable.
- [ice-rest-catalog](ice-rest-catalog/) - A Kubernetes-ready Iceberg REST catalog backed by [etcd](https://etcd.io/).
Run locally with a one-liner: `ice-rest-catalog -c config.yaml`.
- [ice](ice/) - A CLI for interacting with Iceberg REST catalogs.
Create/delete tables, insert data with `ice insert -p ns1.table1 file://example.parquet`, etc.
## Installation
Pre-built binaries\* (+ links to Docker images for [ice](https://hub.docker.com/r/altinity/ice) and [ice-rest-catalog](https://hub.docker.com/r/altinity/ice-rest-catalog)) are available form [GitHub Releases](https://github.com/Altinity/ice/releases) page.
> \* currently require `java` 21+ to run (available [here](https://adoptium.net/installation/)).
## Usage
See [examples/](examples/).
## Development
Install [sdkman](https://sdkman.io/install), then
```shell
git clone https://github.com/altinity/ice && cd ice
# optional but recommended
cp .envrc.sample .envrc
direnv allow
# switch to java specified in .sdkmanrc (done automatically by direnv if `direnv allow`ed)
sdk env
# shows how to build, test, etc. project
./mvnw
```
## License
Copyright (c) 2025, Altinity Inc and/or its affiliates. All rights reserved.
`ice` is licensed under the Apache License 2.0.
See [LICENSE](./LICENSE) for more details.
## Commercial Support
`ice` is maintained by Altinity.
Altinity offers a range of services related to ClickHouse and analytics applications on Kubernetes.
- [Official website](https://altinity.com/) - Get a high level overview of Altinity and our offerings.
- [Altinity.Cloud](https://altinity.com/cloud-database/) - Run ClickHouse in our cloud or yours.
- [Altinity Support](https://altinity.com/support/) - Get Enterprise-class support for ClickHouse.
- [Slack](https://altinity.com/slack) - Talk directly with ClickHouse users and Altinity devs.
- [Contact us](https://hubs.la/Q020sH3Z0) - Contact Altinity with your questions or issues.
- [Free consultation](https://hubs.la/Q020sHkv0) - Get a free consultation with a ClickHouse expert today.