DOC: Add example for multi-column joins using merge
#62016
+36
−0
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
doc/source/whatsnew/vX.X.X.rst
file if fixing a bug or adding a new feature.The goal of this change is to add an explicit example for how to perform a multi-column join. While the existing Comparison with SQL documentation does mention that
merge
supports multiple columns, it is easy to miss and likely requires more research from the user to implement.The reason the new examples are placed inside the
INNER JOIN
section is to continue on from the previous existing "merge()
also offers..." example, and are intended to read as notes about functionality, which can apply to subsequentJOIN
types.