Registry / database / duckdb-extension-iceberg

duckdb-extension-iceberg

JSON →
library1.5.3pypypi✓ verified 86d ago

A DuckDB extension for reading and writing Apache Iceberg tables. Version 1.5.3 supports Iceberg spec v2, time travel, schema evolution, and integration with DuckDB's SQL engine. Released approximately monthly.

database
pip install duckdb-extension-iceberg
github ↗homepage ↗
INSTALL
IMPORT
SIG · DUCKDB-EXTENSION-I
D
duckdb-extension-iceberg
databasepythonv1.5.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

iceberg_ext
✓ import duckdb_extension_iceberg as iceberg_ext
✗ import duckdb_extension_iceberg
Use an alias to avoid name collision, but direct import works as well.

Load the extension and query an Iceberg table using iceberg_scan.

import duckdb import duckdb_extension_iceberg con = duckdb.connect() con.execute("LOAD iceberg") # Read a local Iceberg table con.execute("SELECT * FROM iceberg_scan('path/to/iceberg/metadata') LIMIT 5").show()
Debug
Known issues
gotchaThe extension must be loaded via 'LOAD iceberg' even after importing duckdb_extension_iceberg. Failing to do so results in unrecognized function errors.
fix
Always run con.execute('LOAD iceberg') after installing the extension.
affects: all
breakingIceberg tables written in an older version of the extension may not be readable after upgrading DuckDB without re-creating the database.
fix
Migrate the DuckDB database using the new extension version, or re-import the iceberge tables.
affects: >=0.8.0,<1.0.0
deprecatedThe 'iceberg_list_snapshots' function is deprecated in favor of 'iceberg_snapshots'.
fix
Replace iceberg_list_snapshots(...) with iceberg_snapshots(...).
affects: >=1.5.0
Errors
Common errors & fixes
Error: LOAD failed: could not find 'iceberg' extension
duckdb-extension-iceberg not installed or not importable.
fix
pip install duckdb-extension-iceberg and ensure duckdb is also installed.
Binder Error: Function 'iceberg_scan' not found
Extension not loaded with 'LOAD iceberg'.
fix
Run 'LOAD iceberg' after connecting: con.execute('LOAD iceberg').
Catalog Error: Table with name iceberg_metadata does not exist
Incorrect file path or non-existent metadata file.
fix
Provide the full path to the Iceberg metadata folder (contains version-hint.text, metadata/ directory).
Upgrade
Version history
1.5.3latest on PyPI · released May 29, 2026
Audit
Dependencies
duckdbrequiredRequired to load the extension; must be installed separately.
Agent activity
4 hits · last 30 days
node
4
Resources
githubhttps://github.com/santosh-d3vpl3x/duckdb_extensions ↗
homepagehttps://github.com/santosh-d3vpl3x/duckdb_extensions ↗
duckdb-extension-iceberg — pip install duckdb-extension-iceberg · libregistry