Skip to content

[Datasets] Add pyiceberg docs#2212

Open
lhoestq wants to merge 12 commits intomainfrom
iceberg-docs
Open

[Datasets] Add pyiceberg docs#2212
lhoestq wants to merge 12 commits intomainfrom
iceberg-docs

Conversation

@lhoestq
Copy link
Copy Markdown
Member

@lhoestq lhoestq commented Feb 9, 2026

New:

Updated:

cc @kszucs


Note

Low Risk
Low risk: documentation-only changes, but adds new guidance and examples that could confuse users if commands/URIs are inaccurate.

Overview
Adds new PyIceberg documentation describing how to use faceberg to deploy an Iceberg datasets catalog on Spaces, authenticate, add Hub datasets, and query them via faceberg or native pyiceberg REST catalog clients.

Updates DuckDB docs to include a dedicated authentication section, refreshed hf:// querying examples/output, and a new section showing how to query datasets through an Iceberg catalog (faceberg.namespace.dataset) including split-based filtering and catalog deployment steps.

Navigation/index updates: adds PyIceberg (and PyArrow) entries to the datasets libraries toctree and lists PyIceberg in the libraries table.

Reviewed by Cursor Bugbot for commit 6337ea4. Bugbot is set up for automated code reviews on this repo. Configure here.

@HuggingFaceDocBuilderDev
Copy link
Copy Markdown

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

@lhoestq lhoestq marked this pull request as ready for review February 10, 2026 13:55
@lhoestq lhoestq requested a review from davanstrien February 10, 2026 13:57
@davanstrien
Copy link
Copy Markdown
Member

@lhoestq want a review on this? I think there are some outstanding TODOs in the PR still?

@lhoestq
Copy link
Copy Markdown
Member Author

lhoestq commented Apr 15, 2026

I removed the todo which was not necessary :p

Anyways while this is useful for datasets already, I think content on iceberg will be mostly relevant for buckets in the future

lmk what you think !

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants