Skip to content

docs: Document the TableProvider evaluation order for filter, limit and projection#21091

Open
alamb wants to merge 3 commits intoapache:mainfrom
alamb:alamb/pushdown_order_docs
Open

docs: Document the TableProvider evaluation order for filter, limit and projection#21091
alamb wants to merge 3 commits intoapache:mainfrom
alamb:alamb/pushdown_order_docs

Conversation

@alamb
Copy link
Contributor

@alamb alamb commented Mar 21, 2026

Which issue does this PR close?

Rationale for this change

As mentioned by @hareshkh on #21057 (comment):

It is not clear from the existing documentation that the (logical) evaluation order for push down operations is 'filter -> limit -> projection'

this is the actual order implemented by the built in providers, but it wasn't documented anywhere explicitly

What changes are included in this PR?

  1. Explicitly document the evaluation order on TableProvider
  2. Some drive by cleanups of the documentation

Are these changes tested?

By CI

Are there any user-facing changes?

@github-actions github-actions bot added the catalog Related to the catalog crate label Mar 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

catalog Related to the catalog crate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant