Skip to content

docs: Add point queries blog to Good Reads and Tuning Guide - #26751

Draft
alamb wants to merge 1 commit into
apache:mainfrom
alamb:add-point-queries-blog
Draft

alamb wants to merge 1 commit into
apache:mainfrom
alamb:add-point-queries-blog

Conversation

@alamb

@alamb alamb commented Oct 25, 2026

Copy link
Copy Markdown
Contributor

Which issue does this PR close?

  • N/A (documentation only)

Rationale for this change

Nuno Faria's new blog post, Best Practices for Single Row Lookups (Point Queries) (source: apache/datafusion-site#209), collects practical guidance for getting sub-millisecond point queries out of DataFusion and Parquet.

It should be listed with the other blog posts on the Good Reads page, and the Tuning Guide in the configuration docs currently has nothing about point queries / single row lookups, which is a common use case people ask about.

What changes are included in this PR?

  • Add the blog post to the Good Reads list in concepts-readings-events.md
  • Add a "Point Queries (Single Row Lookups)" section to the Tuning Guide in configs.md summarizing the key recommendations from the post (sort by lookup key, small row groups/pages, target_partitions = 1, pushdown_filters, metadata cache, prepared statements) and linking to the post for details
  • The Tuning Guide text lives in dev/update_config_docs.sh, so that script is updated and configs.md regenerated from it

What is the testing strategy for this PR?

Documentation only. Ran ./dev/update_config_docs.sh and ./ci/scripts/doc_prettier_check.sh --write --allow-dirty; the generated configs.md matches.

Are there any user-facing changes?

Documentation only.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation development-process Related to development process of DataFusion labels Oct 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

development-process Related to development process of DataFusion documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant