Skip to content

Conversation

@muien5080
Copy link

This update adds documentation for NestedLoopJoinExec to the EXPLAIN ANALYZE
/ metrics user guide. The operator recently gained a selectivity metric,
and this PR documents its behavior along with the other join operators.

The new section explains:

  • What NestedLoopJoinExec is used for (non-equijoins and cases where hash
    or sort-merge joins cannot be applied)
  • The metrics it reports under EXPLAIN ANALYZE
  • The meaning of the new selectivity metric (output_rows / input_rows)
  • An example output fragment from an EXPLAIN ANALYZE plan

This helps users interpret nested-loop join behavior and understand join
selectivity during query analysis.

Related: #19045

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Dec 5, 2025
@2010YOUY01
Copy link
Contributor

The metrics don’t seem to match the actual ones, is this PR AI-generated?
If so, FYI: https://datafusion.apache.org/contributor-guide/index.html#ai-assisted-contributions

@Jefffrey Jefffrey assigned Jefffrey and unassigned Jefffrey Dec 30, 2025
@Jefffrey Jefffrey marked this pull request as draft December 30, 2025 04:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants