Apache Iceberg
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Tom Tanaka 6a3b2d7c15
Spark: Remove/migrate remaining JUnit4 tests (#9817)
1 day ago
.baseline Build: Upgrade to Apache RAT 0.16, scanning hidden directories and adding missing ASF header (#9495) 1 month ago
.github Build: Ignore major version update in dependabot (#9806) 3 days ago
.palantir Core: Fix performance issue when combining tasks by partition (#9629) 4 weeks ago
aliyun/src Aliyun: Add security token to client properties (#9671) 1 week ago
api/src API: Fix typo in method comment of SortOrder and SortOrderBuilder (#9816) 2 days ago
arrow/src Parquet, Arrow: Rename BagePageReader to BasePageReader in VectorizedPageIterator (#9630) 4 weeks ago
aws/src AWS: Revert DynamoDb deprecation for 1.5.0 (#9815) 2 days ago
aws-bundle AWS: Upgrade AWS Java SDK version to 2.20.131 (#8379) 6 months ago
azure/src Azure: Bump Azurite container (#9668) 3 weeks ago
azure-bundle Azure: Add FileIO that supports ADLSv2 storage (#8303) 6 months ago
bundled-guava Build: Bump gradle-baseline-java from 4.0.0 to 4.42.0 (#5530) 1 year ago
common/src/main/java/org/apache/iceberg/common ./gradlew spotlessApply 2 years ago
core/src Core: Only test if view exists when using SchemaVersion.V1 during table rename (#9770) 1 week ago
data/src Build: Fix errorprone warning (#9531) 1 month ago
dell/src Core: Close the MetricsReporter when Catalog is closed (#9353) 1 month ago
delta-lake/src Delta: Fix integration tests and Create DataFile by partition values instead of path (#8398) 3 months ago
dev Build/Release: Upgrade to RAT 0.16.1 (#9579) 1 month ago
docs AWS: Revert DynamoDb deprecation for 1.5.0 (#9815) 2 days ago
examples Use SessionState to load Hadoop conf (#642) 4 years ago
flink Flink 1.16, 1.17: Fix iceberg source plan parallelism not effective (#9811) 3 days ago
format Spec: Clarify multi-arg transform behavior for different versions (#9661) 3 days ago
gcp/src GCS: Allow no-auth for testing purposes (#9061) 3 months ago
gcp-bundle AWS, GCP: Include dependency NOTICE content in bundle NOTICE (#8323) 7 months ago
gradle Build: Bump io.netty:netty-buffer from 4.1.68.Final to 4.1.107.Final (#9744) 1 week ago
hive-metastore/src Hive: Unwrap RuntimeException for Hive TException with alter table (#9432) 1 month ago
hive-runtime Core: Default to exponential retry strategy in REST client (#8366) 6 months ago
hive3 Replace `.size() > 0` with `.isNotEmpty()` (#8819) 5 months ago
hive3-orc-bundle Build: Bump Gradle to 8.0.1 (#6826) 1 year ago
kafka-connect Kafka Connect: Sink connector with data writers and converters (#9466) 4 weeks ago
mr MR: Migrate parameterized tests to JUni5 (#9711) 2 weeks ago
nessie/src Core: Add strictness flag to prevent loss of view representation when replacing a view (#9620) 2 weeks ago
open-api Build: Bump datamodel-code-generator from 0.25.3 to 0.25.4 (#9742) 1 week ago
orc/src Core, Spark, Flink, Data: Deliver key metadata for encryption of data files (#9359) 2 months ago
parquet/src Parquet: Add system config for unsafe Parquet ID fallback. (#9324) 1 month ago
pig/src GCP, Pig: Switch tests to JUnit5 (#7647) 10 months ago
project Build: Enforce one import per line in Scalastyle (#2199) 3 years ago
site Docs: Sync contributing page / refer to website for contributing (#9776) 3 days ago
snowflake/src Core: Close the MetricsReporter when Catalog is closed (#9353) 1 month ago
spark Spark: Remove/migrate remaining JUnit4 tests (#9817) 1 day ago
.asf.yaml Docs: Update ASF site to deploy from this repository (#9520) 4 weeks ago
.gitattributes Python: Remove python directory and references (#8695) 5 months ago
.gitignore Remove nightly and add .asf.yaml (#9622) 4 weeks ago
CONTRIBUTING.md Docs: Sync contributing page / refer to website for contributing (#9776) 3 days ago
LICENSE API: Support parameterized tests at class-level with JUnit5 (#9161) 2 months ago
NOTICE Build: Update NOTICE to include copyright to 2022 (#3855) 2 years ago
README.md Docs: Update readme status paragraph (#9272) 3 months ago
baseline.gradle Build: Fix errorprone warning (#9531) 1 month ago
build.gradle Upgrade Nessie to 0.77.1 (#9726) 2 weeks ago
deploy.gradle Build: Add `iceberg-bom` artifact (#8065) 1 month ago
doap.rdf Update doap.rdf (#9507) 1 month ago
gradle.properties Flink: change defaultFlinkVersion back to 1.18 (#9625) 4 weeks ago
gradlew Revert "Bump Gradle to 8.2 (#7955)" (#7995) 8 months ago
jitpack.yml Update build for Apache releases (#531) 4 years ago
jmh.gradle JMH: Improvements to `jmh.gradle` (#9390) 2 months ago
settings.gradle open-api: Use openapi-generator-gradle-plugin for validating specification (#9344) 3 weeks ago
tasks.gradle Build: Add `iceberg-bom` artifact (#8065) 1 month ago




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 Iceberg format specification 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 is available for all libraries and integrations.

Current work is tracked in the roadmap.


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 8, 11, or 17.

  • 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 -DallVersions

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 versions (use runtime jars 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


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

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.


This repository contains the Java implementation of Iceberg. Other implementations can be found at: