Need help with incubator-iceberg?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

2.2K Stars 840 Forks Apache License 2.0 2.1K Commits 811 Opened issues


Apache Iceberg

Services available


Need anything else?

Contributors list


Apache Iceberg is a new table format for storing large, slow-moving tabular data. It is designed to improve on the de-facto standard table layout built into Hive, Trino, and Spark.

Background and documentation is available at


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:
    ./gradlew build
  • To skip tests:
    ./gradlew build -x test -x integrationTest

Iceberg table support is organized in library modules:

  • iceberg-common
    contains utility classes used in other modules
  • iceberg-api
    contains the public Iceberg API
  • iceberg-core
    contains implementations of the Iceberg API and support for Avro data files, this is what processing engines should depend on
  • iceberg-parquet
    is an optional module for working with tables backed by Parquet files
  • iceberg-arrow
    is an optional module for reading Parquet into Arrow memory
  • iceberg-orc
    is an optional module for working with tables backed by ORC files
  • iceberg-hive-metastore
    is an implementation of Iceberg tables backed by the Hive metastore Thrift client
  • iceberg-data
    is an optional module for working with tables directly from JVM applications

This project Iceberg also has modules for adding Iceberg support to processing engines:

  • iceberg-spark2
    is an implementation of Spark's Datasource V2 API in 2.4 for Iceberg (use iceberg-spark-runtime for a shaded version)
  • iceberg-spark3
    is an implementation of Spark's Datasource V2 API in 3.0 for Iceberg (use iceberg-spark3-runtime for a shaded version)
  • iceberg-flink
    contains classes for integrating with Apache Flink (use iceberg-flink-runtime for a shaded version)
  • iceberg-mr
    contains an InputFormat and other classes for integrating with Apache Hive
  • iceberg-pig
    is an implementation of Pig's LoadFunc API for Iceberg


Iceberg's Spark integration is compatible with Spark 2.4 and Spark 3.0 using the modules in the following table:

| Iceberg version | Spark 2.4.x | Spark 3.0.x | | --------------- | ------------- | -------------- | | master branch | spark-runtime | spark3-runtime | | 0.9.0 | spark-runtime | spark3-runtime | | 0.8.0 | spark-runtime | |

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.