Apache Iceberg (incubating) 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, Presto, and Spark.
Background and documentation is available at https://iceberg.incubator.apache.org
Status
Iceberg is under active development in the Apache Incubator.
The core Java library that tracks table snapshots and metadata is complete, but still evolving. Current work is focused on integrating Iceberg into Spark and Presto.
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.
Collaboration
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.
Building
Iceberg is built using Gradle 5.2.1.
- To invoke a build and run tests:
./gradlew build
- To skip tests:
./gradlew build -x test
Iceberg table support is organized in library modules:
iceberg-common
contains utility classes used in other modulesiceberg-api
contains the public Iceberg APIiceberg-core
contains implementations of the Iceberg API and support for Avro data files, this is what processing engines should depend oniceberg-parquet
is an optional module for working with tables backed by Parquet filesiceberg-orc
is an optional module for working with tables backed by ORC files (experimental)iceberg-hive
is an implementation of iceberg tables backed by hive metastore thrift client
This project Iceberg also has modules for adding Iceberg support to processing engines:
iceberg-spark
is an implementation of Spark's Datasource V2 API for Iceberg (use iceberg-runtime for a shaded version)iceberg-data
is a client library used to read Iceberg tables from JVM applicationsiceberg-pig
is an implementation of Pig's LoadFunc API for Iceberg
Compatibility
Iceberg's Spark integration is compatible with the following Spark versions:
Iceberg version | Spark version |
---|---|
0.2.0+ * | 2.3.0 |
0.3.0+ * | 2.3.2 |
master branch | 2.4.x |
An asterisk (*) refers to releases under the now deprecated Netflix/iceberg repo.