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 https://iceberg.apache.org
Iceberg is under active development at the Apache Software Foundation.
The core Java library that tracks table snapshots and metadata is complete, but still evolving. Current work is focused on adding row-level deletes and upserts, and integration work with new engines like Flink and Hive.
The Iceberg format specification is being actively updated and is open for comment. Until the specification is complete and released, it carries no compatibility guarantees. The spec is currently evolving as the Java reference implementation changes.
Java API javadocs are available for the master.
Iceberg tracks issues in GitHub and prefers to receive contributions as pull requests.
Community discussions happen primarily on the dev mailing list or on specific issues.
Iceberg is built using Gradle with Java 1.8 or Java 11.
- To invoke a build and run tests:
- To skip tests:
./gradlew build -x test -x integrationTest
- To fix code style:
Iceberg table support is organized in library modules:
iceberg-commoncontains utility classes used in other modules
iceberg-apicontains the public Iceberg API
iceberg-corecontains implementations of the Iceberg API and support for Avro data files, this is what processing engines should depend on
iceberg-parquetis an optional module for working with tables backed by Parquet files
iceberg-arrowis an optional module for reading Parquet into Arrow memory
iceberg-orcis an optional module for working with tables backed by ORC files
iceberg-hive-metastoreis an implementation of Iceberg tables backed by the Hive metastore Thrift client
iceberg-datais an optional module for working with tables directly from JVM applications
Iceberg also has modules for adding Iceberg support to processing engines:
iceberg-spark2is an implementation of Spark's Datasource V2 API in 2.4 for Iceberg (use iceberg-spark-runtime for a shaded version)
iceberg-spark3is an implementation of Spark's Datasource V2 API in 3.0 for Iceberg (use iceberg-spark3-runtime for a shaded version)
iceberg-flinkcontains classes for integrating with Apache Flink (use iceberg-flink-runtime for a shaded version)
iceberg-mrcontains an InputFormat and other classes for integrating with Apache Hive
iceberg-pigis an implementation of Pig's LoadFunc API for Iceberg
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.