Skip to content
Apache Iceberg (Incubating)
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.baseline Applies the Baseline plugin for iceberg-api only. (#143) Apr 3, 2019
api/src Apply Baseline to iceberg-common and fix Baseline for iceberg-api (#152) Apr 10, 2019
common/src/main/java/org/apache/iceberg/common Apply Baseline to iceberg-common and fix Baseline for iceberg-api (#152) Apr 10, 2019
core/src
data/src
dev Update headers and licensing for Apache. Nov 19, 2018
examples Rename packages to org.apache.iceberg (#138) Mar 20, 2019
gradle/wrapper Applies the Baseline plugin for iceberg-api only. (#143) Apr 3, 2019
hive/src Rename packages to org.apache.iceberg (#138) Mar 20, 2019
orc/src/main/java/org/apache/iceberg/orc Rename packages to org.apache.iceberg (#138) Mar 20, 2019
parquet/src
pig/src
python Python: Remove unused conversions file (#129) Mar 19, 2019
site Turn urls into links in community.md (#148) Apr 5, 2019
spark/src
.gitignore Fix gitignore for IDEA project files. (#5) Nov 26, 2018
.travis.yml Update headers and licensing for Apache. Nov 19, 2018
LICENSE
NOTICE Update headers and licensing for Apache. Nov 19, 2018
README.md
build.gradle Apply Baseline to iceberg-common and fix Baseline for iceberg-api (#152) Apr 10, 2019
gradlew Add gradle wrapper. Jul 18, 2018
settings.gradle Update headers and licensing for Apache. Nov 19, 2018

README.md

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 0.6.0 tag.

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 4.4.

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-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 applications
  • iceberg-pig is an implementation of Pig's LoadFunc API for Iceberg
  • iceberg-presto-runtime generates a shaded runtime jar that is used by presto to integrate with iceberg tables

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.0

An asterisk (*) refers to releases under the now deprecated Netflix/iceberg repo.

You can’t perform that action at this time.