Icebird: JavaScript Iceberg Reader

Icebird: JavaScript Iceberg Reader

Icebird is a library for reading Apache Iceberg tables in JavaScript. It is built on top of hyparquet for reading the underlying parquet files.

Usage

To read an Iceberg table:

const { icebergRead } = await import ( 'icebird' ) const tableUrl = 'https://s3.amazonaws.com/hyperparam-iceberg/spark/bunnies' const data = await icebergRead ( { tableUrl , rowStart : 0 , rowEnd : 10 , } )

To read the Iceberg metadata (schema, etc):

import { icebergMetadata } from 'icebird' const metadata = await icebergMetadata ( { tableUrl } ) // subsequent reads will be faster if you provide the metadata: const data = await icebergRead ( { tableUrl , metadata , } )

Demo

Check out a minimal iceberg table viewer demo that shows how to integrate Icebird into a react web application using HighTable to render the table data. You can view any publicly accessible Iceberg table:

Live Demo : https://hyparam.github.io/demos/icebird/

... continue reading