PyPI · #790 most downloaded on PyPI

pyiceberg

0.12.020M downloads/moapache/iceberg-python ↗New releases in your daily digest, changelog included.

Apache Iceberg is an open table format for huge analytic datasets

Last release 1 months ago
01 Sep 2026
Release timing varies
gaps range from 8 days to 5 months
Most releases are documented
notes for 13 of 19 stable releases
2 versions withdrawn
withdrawn after publishing
4 years old
64 releases · first in 2022

Release timeline

64 releases since 2022

20222023202420252026

20222026

One column per quarter.

Releases

0.12.01 Sept 2026Deprecated
feat(cli): deprecate version command in favor of --version flag by @chrisqiqiu in #3206
What's Changed

Catalog tests around nonexistent tables + namespaces by @rambleraptor in #2990

Upgrade to RAT 0.17 by @kevinjqliu in #2992

Fix: make test-coverage to properly enable coverage for all test suites by @kevinjqliu in #2989

feat: Add tell() to OutputStream writers by @geruh in #2998

infra: upgrade pytest and use pytest_lazy_fixtures by @kevinjqliu in #2978

fix: ignore local config during tests by @geruh in #3006

fix: Hive catalog test failure on CPython 3.13.12 by @geruh in #3043

docs: release docs improvements by @kevinjqliu in #3030

Add catalog properties for Catalog Tests by @rambleraptor in #2982

feat: Add Geometry & Geography Types by @SaymV in #2859

infra: set github actions max-parallel to 15 by @kevinjqliu in #3057

fix: Accept all valid http method for IRC's ConfigResponse by @sumanth-manchala in #3010

feat(cli): add --prefix option for REST catalog by @mrutunjay-kinagi in #3061

CI: Add CodeQL workflow for GitHub Actions security scanning by @kevinjqliu in #3060

Surface too many requests exception by @ms32035 in #3048

fix: add Field alias for SetPartitionStatisticsUpdate.partition_stati… by @shiwk in #3035

fix ssl deactivation from catalog properties #2985 by @MenelikV in #3012

Optimization: Prune manifest in snapshot overwrite operations by @gabeiglio in #3011

Add concurrency safety validation checks by @gabeiglio in #3049

infra: simplify Makefile and uv by @kevinjqliu in #2996

fix: Extract ADLS account_name from URI hostname in FsspecFileIO by @antonlin1 in #3005

Fix conftest dependency breaking nightly wheel build by @kevinjqliu in #3078

chore: Remove docs from uv default groups by @geruh in #3073

fix: show helpful error when hive catalog config is missing uri by @jx2lee in #3077

chore(ci): add explicit least-privilege workflow permissions by @kevinjqliu in #3082

fix: python version in release docs workflow by @geruh in #3102

chore: use ubuntu-slim for lightweight jobs by @zhjwpku in #3107

Fix pyparsing diagnostic warning on Table import by @kevinjqliu in #3081

Documentation Adjustment for s3.profile-name and client.profile-name by @thomas-pfeiffer in #3085

docs: more release docs improvements by @kevinjqliu in #3104

feat(cli): replace REST --prefix with --warehouse by @kevinjqliu in #3080

Update slate config for PRs by @nssalian in #3125

Support storage-credentials in REST catalog LoadTableResult by @rcjverhoef in #3042

feat(rest): add sigv4 retry configuration defaults by @mrutunjay-kinagi in #3063

[View Support] Add ViewMetadata read support and create_view to REST Catalog by @rambleraptor in #2154

fix: handle empty HEAD response by @AntonioYuen in #3041

Switch to uv-pre-commit for lockfile management by @kevinjqliu in #3141

Improve lockfile management documentation and enforce uv.lock freshness in CI by @kevinjqliu in #3144

Fix for ns timestamp non utc by @nssalian in #3142

Skip catalog loading for the version command by @jx2lee in #3146

docs: add type mapping tables between PyIceberg and PyArrow by @iamluan in #3098

fix(glue): Support create_table for S3 Tables federated databases by @jamesbornholt in #3058

ci: pin third-party actions to Apache-approved SHAs by @kevinjqliu in #3172

Infra: Remove GitHub Actions from Dependabot configuration by @kevinjqliu in #3187

Infra: Pin pypa/cibuildwheel version by @ebyhr in #3189

chore(ci): pin actions in PR-triggered workflows by @kevinjqliu in #3194

chore(ci): pin actions in non-PR-triggered workflows by @kevinjqliu in #3193

ci: improve github workflows by @kevinjqliu in #3204

ci: add tag as inline comment by @kevinjqliu in #3213

ci: fix nightly and release by @kevinjqliu in #3215

fix: Handle optional properties in load namespace properties response by @geruh in #3169

CI: Lock REST Fixture to 1.10.1 by @Fokko in #3240

fix zizmor ci issue by bumping codeql-action to v4.35.2 by @geruh in #3245

ci: fix zizmor workflow by @kevinjqliu in #3243

Fix ManifestEntry.snapshot_id setter writing to wrong index by @lawofcycles in #3257

Fix pa.Schema type annotations in schema_to_pyarrow by @davidbzhao in #3261

perf: build partition filter with balanced tree to avoid RecursionError by @yingjianwu98 in #3264

bug: NoopCatalog should return False, not throw error by @rambleraptor in #3284

Reading upper/lower bounds values with type promotions by @rambleraptor in #3293

Fix DELETED manifest entry snapshot_id in OverwriteFiles by @lawofcycles in #3237

infra: add python 3.14 support by @afeldman1 in #3299

fix: SaslServer busy-loop causes process hang after test suite by @kevinjqliu in #3305

perf: Hoist table_metadata at remaining repeat-access sites in snapshot update by @rynewang in #3301

Fix deepcopy for And, Or, and Not expressions by @robreeves in #3295

Add support for 'overwrite' option in register_table by @ebyhr in #3290

Document TableAlreadyExistsError in catalog.rename_table by @ebyhr in #3289

Initial work for file format writer API by @nssalian in #3119

fix:update config during table refresh by @yingjianwu98 in #3327

Remove unused code by @ebyhr in #3326

Update NOTICE year 2025 -> 2026 by @kevinjqliu in #3332

CI: Use specific patch versions in workflow action comments by @kevinjqliu in #3331

feat: add load_view to REST catalog by @spr0els in #3224

Add support for registering views by @ebyhr in #3288

fix(tests): isolate state in test_write_optional_list by @paultmathew in #3334

add papermill-based notebook tests for pyiceberg examples by @federicsp in #3330

REST: Add pagination support for list_views by @ebyhr in #3349

fix(fsspec): handle zero-byte files in len by @fallintoplace in #3353

Add @typing.override annotations to catalog and FileIO implementations by @vishnuprakaz in #3360

Fix typo in test_add_files by @ebyhr in #3378

fix: avoid TSaslClientTransport reuse to eliminate server-side SASL noise by @barking-code in #3357

feat(2152): support pa.RecordBatchReader in Table.append/overwrite by @paultmathew in #3335

REST: Rename rest-scan-planning-enabled to scan-planning-mode by @ebyhr in #3376

fix(table): avoid committing update builders after exceptions by @fallintoplace in #3354

perf(add_files): stream manifest entries for duplicate-files check by @laichunpongben in #3287

Build: Update actions/upload-artifact to v7.0.1 by @ebyhr in #3401

docs: fix New York longitude sign in partial overwrite example by @fallintoplace in #3403

Test: Replace rest-scan-planning-enabled with scan-planning-mode by @ebyhr in #3391

feat(view): View object API by @gabeiglio in #3338

REST: Add pagination support for list_namespaces by @ebyhr in #3347

REST: Add pagination support for list_tables by @ebyhr in #3348

Make View.sql_for case-insensitive and return None for unknown dialect by @ebyhr in #3407

REST: Add integration test for views by @ebyhr in #3406

REST: Add support for page-size in list_namespaces, list_tables, and list_views by @ebyhr in #3377

REST: Allow Identifier type in drop_view method by @ebyhr in #3408

feat(cli): deprecate version command in favor of --version flag by @chrisqiqiu in #3206

Fix walrus truthiness on metrics bounds and identity-partition projection by @kevinjqliu in #3412

Reject empty source-ids in PartitionField / SortField by @kevinjqliu in #3411

Fix precision loss in large integral string conversions by @fallintoplace in #3405

Chore: Updated PyArrow Dependencies by @CalebWeisgerber in #3362

Fix typo by @ebyhr in #3424

docs: add Iceberg security model by @sungwy in #3425

Add rambleraptor to collaborators list by @kevinjqliu in #3456

Make View.version return None for unknown id by @ebyhr in #3445

DOCS: Fix layout of sqlite warning by @ebyhr in #3459

Fix misleading file extension for partition statistics by @ebyhr in #3472

fix(literals): return long bounds for decimal conversion by @abnobdoss in #3470

Add defaults to ViewVersion fields by @ebyhr in #3458

Update astral-sh/setup-uv to v8.2.0 by @ebyhr in #3510

feat: add dictionary_columns to to_arrow() / to_arrow_batch_reader() for memory-efficient reads by @GayathriSrividya in #3461

Refactor: extract BaseScan and ManifestGroupPlanner by @smaheshwar-pltr in #3511

Add more examples for pyiceberg view by @MonkeyCanCode in #3414

feat: Add REST loadCredentials support by @kevinjqliu in #3499

fix: correct NOT STARTS WITH projection for truncated partitions by @GayathriSrividya in #3528

Fix NotStartsWith residual evaluation to return correct result by @ebyhr in #3503

Return overflow sentinel in LongLiteral.to(FloatType) by @ebyhr in #3502

Fix string-based starts_with and not_starts_with methods by @ebyhr in #3501

Return bounds sentinels for long date literals by @kevinjqliu in #3546

Fix duplicate filtering path in Arrow task batches by @GayathriSrividya in #3448

docs: clean OSS and COS configuration tables by
Note truncated.

0.11.010 Feb 2026Deprecated

Remove 0.11.0 deprecated methods by @rambleraptor in #2983

What's Changed

Bump version in iceberg-bug-report.yaml by @Fokko in #2463
Bump version in Dockerfile by @Fokko in #2464
add docker cleanup to integration tests by @geruh in #2465
Fix prefix match for ADLS_SAS_TOKEN by @tom-s-powell in #2461
fix: correct type mismatch in BinaryEncoder write by @zhongyujiang in #2460
infra: let Makefile execute command from python by @kevinjqliu in #2476
infra: update github action runners by @kevinjqliu in #2484
Remove user flag from poetry installation by @geruh in #2486
infra: prefer downloads.apache.org, fallback to archive.apache.org by @kevinjqliu in #2494
BUG: Add assert spec id to requirements in spec update by @gabeiglio in #2489
infra: use spark connect to run pytests by @kevinjqliu in #2491
Fix FsspecFileIO.get_fs thread safety by @lwfitzgerald in #2495
Fix renames of tpep_pickup_datetime → tpep_pickup_day by @Fokko in #2496
Bump Iceberg to 1.10.0 in CI by @Fokko in #2497
feat: Support of branches in add_files by @vinjai in #2485
Add RemoveSchemasUpdate event by @rambleraptor in #2200
Add comprehensive ORC read support to PyArrow I/O by @mccormickt12 in #2432
Run Catalog integration tests against REST Catalog impls by @rambleraptor in #2482
Add RemovePartitionSpecsUpdate event by @rambleraptor in #2198
Support fsspec s3 addressing_style properties by @fcfangcc in #2517
Expire snapshot mutability issue by @ForeverAngry in #2430
Manage snapshots mutability issue by @ForeverAngry in #2431
fix: incorrect descriptions of snapshot operations by @zhongyujiang in #2513
Bump griffe by @TiansuYu in #2532
Upgrade poetry to latest (2.2.1) by @gregunz in #2535
Re-use connections when remote S3 signing by @lwfitzgerald in #2543
add lock for cachetools by @Gowthami03B in #2555
Serialize true false by @nathanbijleveld in #2538
infra: use spark base image for docker by @kevinjqliu in #2540
Feat/update sort order by @Fokko in #2552
infra: group spark files into dev/spark/ by @kevinjqliu in #2563
infra: cleanup filterwarnings by @kevinjqliu in #2569
infra: upgrade spark to 4.0.1 by @kevinjqliu in #2566
infra: remove outdated filterwarnings by @kevinjqliu in #2568
Make Reference JSON serializable by @Fokko in #2564
Make ExecutorFactory multi-process safe by @iatkinson in #2546
Support arbitrary literal comparisons in BETWEEN operator by @jtuglu1 in #2567
DOCS: Add better docs for tags and branches by @gabeiglio in #2571
Replace pre-commit by prek by @luizvbo in #2533
Simplify ray contraint by @Fokko in #2573
Make Literal Pydantic serializeable by @Fokko in #2575
[Upstream Error] Pin pydantic version <2.12.0 to avoid regression by @HonahX in #2591
Add analytics block on Pyiceberg website by @rambleraptor in #2587
Make SetPredicate and Subclasses JSON Serializable with Pydantic by @Aniketsy in #2557
Add transaction tests to catalog integration tests by @gabeiglio in #2371
docs: Add installing guide for Datafusion API by @manuzhang in #2597
docs: Note pyiceberg only works with datafusion < 49 by @manuzhang in #2602
build: Run linter in Python CI Docs by @manuzhang in #2603
Consolidate register_table tests in test_catalog.py by @gabeiglio in #2595
Add namespace check on RestCatalog.rename_table by @rambleraptor in #2588
[#2624] docs: add gravitino REST catalog use example by @FANNG1 in #2625
table.inspect.partitions(): add filter expression by @emilie-wang in #2596
Fix expression tests by @Fokko in #2632
feat: make LiteralPredicate serializable via internal IcebergBaseModel by @jaimeferj in #2561
Fix after model validator signatures by @Viicos in #2626
dep: disallow pydantic 2.12.0 and 2.12.1, update poetry lock to use pydantic 2.12.3 by @kevinjqliu in #2635
Fix StaticTable._metadata_location_from_version_hint metadata location format ERROR by @qccash in #2609
Remove Python 3.9 support by @Aniketsy in #2554
nit: Remove dangling string by @Fokko in #2650
Remove the unneeded suppression by @Fokko in #2654
Feat/json serialize or expression by @jaimeferj in #2565
Make UnaryPredicate JSON Serializable and Add Unit Tests by @Aniketsy in #2598
Row lineage fields for v3 by @rambleraptor in #2129
Add tests for Partition Spec Evolution by @rambleraptor in #2479
feat: replace ExpressionA with IsNull("a") and ExpressionB with IsNul… by @jaimeferj in #2651
Make Not expression JSON serializable by @Aniketsy in #2593
API: fix: inject header prior to AuthManager by @rinzool in #2656
Refactor glue to iceberg table conversion by @geruh in #2660
fix checking physical type for Decimal type in StatsAggregator by @gweaverbiodev in #2515
[docs] Update "how to release" doc by @kevinjqliu in #1700
perf: do not copy metadata for each data file in summary by @Anton-Tarazi in #2674
Fix Nightly PyPi Artifact Wheels Build by @geruh in #2678
perf: iterate over generators when writing datafiles to reduce memory pressure by @hamilton-earthscope in #2671
Fix partition column projection with schema evolution by @KevinJiao in #2685
infra: use apache/hive:4.0.0 as hive Dockerfile base image by @kevinjqliu in #2697
update prek libraries, make lint by @kevinjqliu in #2696
lint: remove ignoring ruff rule B905 (zip-without-explicit-strict) by @kevinjqliu in #2701
lint: remove ignoring ruff rule E203 (whitespace-before-punctuation) by @kevinjqliu in #2703
fix: Pass snapshot_id as keyword argument to RemoveStatisticsUpdate by @ForeverAngry in #2694
mypy: Ignore missing annotations globally by @Fokko in #2704
Limit split so colons are allowed in the password by @martelli in #2706
Add support for UV dependency management by @geruh in #2601
docs: update contributing.md with uv by @geruh in #2733
Fix: Support nested struct field filtering with PyArrow (#953) by @yiftizur in #2628
pyproject.toml: move homepage and repo up by @kevinjqliu in #2736
Renable linter rule B024 by @rambleraptor in #2737
sdist: remove .egg-info and setup.cfg from sdist by @kevinjqliu in #2734
Makefile: apply PYTHON_ARG override in all uv commands by @kevinjqliu in #2735
Re-enable rule B208 by @rambleraptor in #2738
Enable up037 by @rambleraptor in #2739
Enables linter rule UP006 by @rambleraptor in #2744
docs: add GCP BigLake Metastore Catalog configuration example by @heathkh-recursion in #2740
dont need pyiceberg-core in some optional deps by @kevinjqliu in #2748
infra: notify on github workflow failure by @kevinjqliu in #2682
Fix check-md-link and allow manual trigger by @kevinjqliu in #2765
Remove Generic from expressions by @Fokko in #2750
Remove UP035 from ruff ignore list by @rambleraptor in #2767
Follow up on cleaning up the removal of Generic by @Fokko in #2769
infra: add instructions for cleaning up testpypi artifacts by @kevinjqliu in #2774
fix: Remove unused fields from FileScanTask by @geruh in #2777
fix: Serialize AlwaysTrue/AlwaysFalse as boolean literals by @geruh in #2780
chore: add pyarrow-stubs dependency for type hint & suggestion by @dingo4dev in #2768
fix: Set Expression serialization to use 'values' by @geruh in #2782
feat: Make AND expression JSON serializable by @geruh in #2784
Add missing ORC iceberg.required attribute by @ebyhr in #2789
infra: use new del_branch_on_merge in .asf.yaml by @kevinjqliu in #2788
JSON to expression by @Fokko in #2783
Read partitioned tables with source field missing from schema by @gabeiglio in #2367
docs: Update pyiceberg CLI help docs by @el10savio in #2793
Remove field id constraint on add files by @jeroko in #2662
fix: Allow writing data with missing optional map fields by @somasays in #2797
docs: add example for microsoft onelake iceberg rest catalog by @NNSatyaKarthik in #2796
infra: add the missing setup-uv step by @kevinjqliu in #2824
feat: Add RESTscan Planning Endpoints and config by @geruh in #2842
Run uv lock --upgrade to upgrade pyparsing by @Fokko in #2850
Core: Fix bin packing when target file size is smaller than a row by @010Soham in #2844
Core: Respect partition evolution in inspect.partitions by @010Soham in #2845
fix: Add Cython build step to Makefile by @geruh in #2869
feat: Add models for rest scan planning by @geruh in

Note truncated.

Open source →