Skip to content

Improved#3643 Fuzzy Match return distances for multiple matches(Top-K/separate rows) - #7849

Open
leehaut wants to merge 1 commit into
apache:mainfrom
leehaut:hotfix/lance-common-113
Open

Improved#3643 Fuzzy Match return distances for multiple matches(Top-K/separate rows)#7849
leehaut wants to merge 1 commit into
apache:mainfrom
leehaut:hotfix/lance-common-113

Conversation

@leehaut

@leehaut leehaut commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Fix #3643

Summary

Previously, Fuzzy Match only returned a measure (distance / similarity) when Get closer value was enabled. In multi-match mode, matches were concatenated without their distances.

This change replaces the closer-value checkbox with an explicit Match mode, and supports retrieving multiple matches together with measure values:

Match mode Behavior
Closest match Single best match (previous closer-value behavior)
All matches (separate rows) One output row per match, ranked best-first, limited by Top-K (recommended)
All matches (concatenated) Matches and measures joined with the values separator (literal #3643 request)

Details

  • Add MatchMode (closest / all_rows / all_concat) with backward compatibility for existing closervalue pipelines
  • Add Max matches Top-K (default 10, hard-capped at 100) using a bounded priority heap (no full in-memory sort of all candidates)
  • Value field is available in all modes; concatenated mode returns measures as a separator-aligned string list
  • Additional lookup fields remain available for closest and separate-rows modes
  • Update UI, i18n (en_US / zh_CN), and user docs (fuzzymatch.adoc, joins/lookups guide)

…rate rows)

Signed-off-by: lance <leehaut@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request]: Fuzzy match - get distance values together with multiple matches

1 participant