Skip to content

Document the relationship between FileFormat::projection / FileFormat::filter and FileScanConfig::output_ordering#20196

Open
alamb wants to merge 2 commits intoapache:mainfrom
alamb:alamb/output_ordering_docs
Open

Document the relationship between FileFormat::projection / FileFormat::filter and FileScanConfig::output_ordering#20196
alamb wants to merge 2 commits intoapache:mainfrom
alamb:alamb/output_ordering_docs

Conversation

@alamb
Copy link
Contributor

@alamb alamb commented Feb 6, 2026

Which issue does this PR close?

Rationale for this change

I spent a long time trying to figure out what was going on in our fork after
a DataFusion 52 upgrade, and the root cause was that the output_ordering in DataFusion
52 does NOT include the projection (more details here #20173 (comment))

This was not clear to me from the DataFusion code or documentation, and I think
it would be helpful to clarify this in the documentation.

What changes are included in this PR?

  1. Document FileScanConfig::output_ordering better

Are these changes tested?

Are there any user-facing changes?

…::filter and FileScanConfig::output_ordering
@github-actions github-actions bot added the datasource Changes to the datasource crate label Feb 6, 2026
@alamb alamb marked this pull request as ready for review February 7, 2026 12:22
@alamb alamb added the documentation Improvements or additions to documentation label Feb 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

datasource Changes to the datasource crate documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Existing file ordering is lost in some cases with projections

1 participant