Skip to content

docs: clarify distance metric mismatch behavior - #362

Merged
daisukebe merged 1 commit into
mainfrom
daisuke/vector-search-distance-metric-docs
Sep 24, 2026
Merged

daisukebe merged 1 commit into
mainfrom
daisuke/vector-search-distance-metric-docs

Conversation

@daisukebe

@daisukebe daisukebe commented Sep 17, 2026 •

Copy link
Copy Markdown
Contributor

Fixes https://linear.app/lancedb/issue/DOC-81

Summary

  • clarify that an explicitly mismatched query metric prevents use of the vector index
  • document the brute-force fallback and the LanceDB Enterprise safety limit
  • distinguish current SDK behavior from older clients that sent l2 when the metric was omitted
  • align the vector search, vector indexing, and performance guides

Validation

  • git diff --check
  • npx --yes mintlify@latest broken-links

Comment thread docs/indexing/vector-index.mdx Outdated
The `distance_type` can be specified at search time in addition to build time. If
you do this, set it to the same value used to build the vector index. If the search
metric does not match the index metric, LanceDB cannot use the index and falls
back to a costly flat search. On LanceDB Enterprise, the brute-force KNN safety

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it might be worth double checking if this applies to enterprise or just "cloud"

@wkalt wkalt left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one note to check

@daisukebe
daisukebe force-pushed the daisuke/vector-search-distance-metric-docs branch from 72e06a8 to d99dfa4 Compare September 24, 2026 02:54
@daisukebe
daisukebe merged commit 7fa2ff6 into main Sep 24, 2026
4 checks passed
@daisukebe
daisukebe deleted the daisuke/vector-search-distance-metric-docs branch September 24, 2026 03:21
jackye1995 added a commit that referenced this pull request Sep 26, 2026
Cherry-picked from main, which is not the deployed branch during the migration.
Drops the assemble.yml hunk that came with it: that workflow does not exist on
this branch.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants