+2
Daily
9,437
stars
3,692
forks
182
watchers
13,785
prs
5,165
issues
35
releases
README
!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:[email protected] Building Iceberg is built using Gradle with Java 17 or 21. To invoke a build and run tests: ./gradlew build To skip tests: ./gradlew build -x test -x integrationTest To fix code style for default versions: ./gradlew spotlessApply To fix code style for all versions of Spark/Hive/Flink:./gradlew spotlessApply -DallModules 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 Iceberg also has modules for adding Iceberg support to processing engines: iceberg-spark is an implementation of Spark's Datasource V2 API for Iceberg with submodules for each Spark version (use runtime jars for a shaded version to avoid dependency conflicts) 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 --- 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: sudo ln -s $HOME/.docker/run/docker.sock /var/run/docker.sock In some cases the testcontainer may exit with an initialization error because of an illegal state exception in the GenericContainer. One work arou
Top issues
#10392Variant Data Type Support36 comments · 2024-05-29#13763Duplicate file path found in Iceberg metadata snapshot32 comments · 2025-08-07#13593Metadata stop to be written after random period of time. Commit failed, will try again next cycle.32 comments · 2025-07-18#12878org.apache.thrift.TApplicationException: Invalid method name: 'get_table'32 comments · 2025-04-23#11648SparkExecutorCache causes slowness of RewriteDataFilesSparkAction30 comments · 2024-11-25#13752Kafka Connect drop messages when Glue Exception is happening28 comments · 2025-08-06#12937Remove JUnit4 dependency from Flink22 comments · 2025-04-30#12653Spark: MERGE INTO Statements with only WHEN NOT MATCHED Clauses are always executed at Snapshot Isolation17 comments · 2025-03-26
Latest release
apache-iceberg-1.12.0 apache-iceberg-1.12.0 2026-09-30What's Changed Build: Designate a single Gradle cache writer across CI workflows by @kevinjqliu in https://github.com/apache/iceberg/pull/16356 Core: Fix ByteBufferInputStream.read() to return -1 at EOF by @sachinnn99 in https://github.com/apache/iceberg/pull/16167 Website: remove duplicated entries from search by @MaxNevermind in https://github.com/apache/iceberg/pull/16368 Build: Bump pymarkdownlnt from 0.9.36 to 0.9.37 by @dependabot[bot] in https://github.com/apache/iceberg/pull/16372 Build: Bump datamodel-code-generator from 0.56.1 to 0.57.0 by @dependabot[bot] in https://github