Skip to content

docs: Document missing write table properties in configuration - #3879

Merged
kevinjqliu merged 4 commits into
apache:mainfrom
damansingh1313:docs-missing-table-properties
Oct 24, 2026
Merged

kevinjqliu merged 4 commits into
apache:mainfrom
damansingh1313:docs-missing-table-properties

Conversation

@damansingh1313

Copy link
Copy Markdown
Contributor

The write-options table omitted several properties that PyIceberg reads when writing, including write.target-file-size-bytes, write.format.default, write.avro.compression-codec, the Parquet row-group/bloom-filter sizes, the column metrics-mode properties and write.summary.partition-limit. Add rows for them and fix a typo ("coddec" -> "codec") in the existing compression-codec entry.

Rationale for this change

Are these changes tested?

these are changes in the md file which do not require testing

Are there any user-facing changes?

@damansingh1313

Copy link
Copy Markdown
Contributor Author

Hi @kevinjqliu
Could you please review the PR.

@Fokko
Fokko enabled auto-merge September 18, 2026 19:39
@github-actions

Copy link
Copy Markdown

This pull request has been marked as stale due to 30 days of inactivity. It will be closed in 1 week if no further activity occurs. If you think that's incorrect or this pull request requires a review, please simply write any comment. If closed, you can revive the PR at any time and @mention a reviewer or discuss it on the dev@iceberg.apache.org list. Thank you for your contributions.

@github-actions github-actions Bot added the stale label Oct 19, 2026
The write-options table omitted several properties that PyIceberg reads
when writing, including write.target-file-size-bytes, write.format.default,
write.avro.compression-codec, the Parquet row-group/bloom-filter sizes,
the column metrics-mode properties and write.summary.partition-limit. Add
rows for them and fix a typo ("coddec" -> "codec") in the existing
compression-codec entry.
auto-merge was automatically disabled October 21, 2026 18:54

Head branch was pushed to by a user without write access

@damansingh1313
damansingh1313 force-pushed the docs-missing-table-properties branch from c3b488d to 23002e4 Compare October 21, 2026 18:54
@github-actions github-actions Bot removed the stale label Oct 22, 2026
@rambleraptor

Copy link
Copy Markdown
Collaborator

@Fokko can you put this in the merge queue? Looks like you set it to automerge last month + it never made its way through

@rambleraptor rambleraptor left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, let's get this merged!

kevinjqliu and others added 2 commits October 24, 2026 10:54
PyIceberg ignores write.parquet.row-group-size-bytes and the bloom-filter
properties, emitting a "not implemented" warning when they are set.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Clarify how write.target-file-size-bytes is measured, what each metrics
mode collects, which files the Avro codec applies to, and that the default
write.summary.partition-limit of 0 disables partition summaries.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

@kevinjqliu kevinjqliu left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

I clean up the PR a bit

  • Removed 3 entries. write.parquet.row-group-size-bytes, write.parquet.bloom-filter-max-bytes, and write.parquet.bloom-filter-enabled.column.{column-name} are not implemented in this repo (8b5f5be)
  • Some nit wording changes on docs (058ae56, ea0b57b)

@kevinjqliu
kevinjqliu enabled auto-merge October 24, 2026 17:56
The none mode still records column sizes, and nested fields are capped at
counts regardless of the configured mode.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@kevinjqliu
kevinjqliu added this pull request to the merge queue Oct 24, 2026
Merged via the queue into apache:main with commit c688f1e Oct 24, 2026
21 checks passed
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.

4 participants