apache / iceberg

Iceberg is a high-performance format for huge analytic tables. Iceberg brings the reliability and simplicity of SQL tables to big data, while making it possible for engines like Spark, Trino, Flink, Presto, Hive and Impala to safely work with the same tables, at the same time. Background and documentation is available at Status Iceberg is under active development at the Apache Software Foundation. The [Iceberg format specification][iceberg-spec] is stable and new features are added with each version. The core Java library is located in this repository and is the reference implementation for other libraries. [Documentation][iceberg-docs] is available for all libraries and integrations. [iceberg-docs]: https://iceberg.apache.org/docs/latest/ [iceberg-spec]: https://iceberg.apache.org/spec/ Collaboration Iceberg tracks issues in GitHub and prefers to receive contributions as pull requests. Community discussions happen primarily on the [dev mailing list][dev-list] or on specific issues. [dev-list]: mailto:dev@iceberg.apache.org Building Iceberg is built using Gradle with Java 17 or 21. • To invoke a build and run tests: • To skip tests: • To fix code style for default versions: • To fix code style for all versions of Spark/Hive/Flink: Iceberg table support is organized in library modules: • contains utility classes used in other modules • contains the public Iceberg API • contains implementations of the Iceberg API and support for Avro data files, **this is what processing engines should depend on** • is an optional module for working with tables backed by Parquet files • is an optional module for reading Parquet into Arrow memory • is an optional module for working with tables backed by ORC files • is an implementation of Iceberg tables backed by the Hive metastore Thrift client • is an optional module for working with tables directly from JVM applications Iceberg also has modules for adding Iceberg support to processing engines: • is an implementation of Spark's Datasource V2 API for Iceberg with submodules for each spark versions (use runtime jars for a shaded version to avoid dependency conflicts) • contains classes for integrating with Apache Flink (use iceberg-flink-runtime for a shaded version) • contains an InputFormat and other classes for integrating with Apache Hive --- **NOTE** The tests require Docker to execute. On macOS (with Docker Desktop), you might need to create a symbolic name to the docker socket in order to be detected by the tests: In some cases the testcontainer may exit with an initialization error because of an illegal state exception in the GenericContainer. One work around for this problem is to set into permissive mode before running the tests. --- Documentation For information about building the documentation, see here. Engine Compatibility See the Multi-Engine Support page to know about Iceberg compatibility with different Spark, Flink and Hive versions. For other engines such as Presto or Trino, please visit their websites for Iceberg integration details. Implementations This repository contains the Java implementation of Iceberg. Other implementations can be found at: • **Go**: iceberg-go • **PyIceberg** (Python): iceberg-python • **Rust**: iceberg-rust • **C++**: iceberg-cpp