Skip to content

A temporary home for LinkedIn's changes to Apache Iceberg (incubating)

License

Notifications You must be signed in to change notification settings

linkedin/iceberg

Folders and files

NameName
Last commit message
Last commit date
Dec 4, 2020
Jun 1, 2022
Feb 16, 2023
Jan 19, 2021
Jan 8, 2021
Jan 19, 2021
Sep 22, 2020
Mar 15, 2024
Jun 30, 2023
Nov 3, 2020
Nov 13, 2019
Jan 22, 2021
Jun 30, 2023
Nov 13, 2019
Jul 25, 2022
Jan 22, 2021
Jan 22, 2021
Mar 15, 2024
Feb 8, 2022
Jul 25, 2022
Apr 9, 2024
Sep 21, 2021
Jan 22, 2021
Jan 7, 2021
Dec 5, 2020
Jun 21, 2021
Jan 22, 2021
Apr 9, 2024
Jun 30, 2023
Jan 22, 2021
Jan 22, 2021
Apr 27, 2023
Oct 29, 2020
Sep 15, 2020
Jan 19, 2021
Jan 22, 2021
Jan 19, 2021
Sep 24, 2020
Nov 13, 2020
Mar 22, 2023
Jun 2, 2022
Dec 4, 2020
Oct 15, 2019
Oct 10, 2019
Jun 24, 2020
Apr 21, 2022
Oct 26, 2022
Jun 1, 2022
Feb 16, 2023

Repository files navigation

Slack

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, Presto, and Spark.

Background and documentation is available at https://iceberg.apache.org

Status

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.

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.4.1 with Java 1.8 or Java 11.

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

Compatibility

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