dataiceberg

README

data-iceberg

_{part of the togo-framework}

A togo data backend that queries Apache Iceberg tables through DuckDB (which reads Iceberg natively). Registers into data's slot.

togo install togo-framework/data-iceberg
togo provider:use data iceberg
# then query with DuckDB's iceberg_scan('s3://…/table')

Key	Default	Purpose
ICEBERG_DUCKDB_BIN	duckdb	duckdb binary
ICEBERG_INIT	INSTALL iceberg; LOAD iceberg;	setup SQL

This is the "tier-out" escape hatch from data-pg: hot data stays in Postgres, cold/shared data lives in Iceberg on object storage — both queryable.

MIT © fadymondy

Documentation

Overview

Package dataiceberg is a togo data backend that queries Apache Iceberg tables through DuckDB (which reads Iceberg natively). Select with `togo provider:use data iceberg`.

ICEBERG_DUCKDB_BIN  duckdb binary (default "duckdb")
ICEBERG_INIT        setup SQL run before each query
                    (default "INSTALL iceberg; LOAD iceberg;")

Point queries at your tables with iceberg_scan('s3://…/table') per DuckDB's iceberg extension.