●Change8

Migrating to LanceDB v0.31.0

Version v0.31.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 7/2/2026

2
Breaking Changes
2
Migration Steps
19
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

IndexStatisticscreate_indexmerge_insertPyTorch dataloadersupdate_field_metadatareplace_field_metadataquery.to_pandasTable.deletewhen_not_matched_by_source_deleterename_tableLanceNamespaceDatabaseIndexConfigTable.searchvalue_to_sqlRRFReranker.rerank_multivectorLanceDBClientErrorlist_indicesdescribe_indicespermutation API

Breaking Changes

●Issue #1

The 'loss' field has been removed from IndexStatistics.

●Issue #2

Repeated 'where' filters in queries are now combined using AND logic instead of the previous behavior of replacing them.

Migration Steps

  1. 1
    If you relied on repeated 'where' filters being replaced, update your query logic as they are now combined with AND.
  2. 2
    Replace usage of 'replace_field_metadata' with 'update_field_metadata'.

Release Summary

This release introduces significant new features including table branching, Polars integration, and OAuth support, alongside breaking changes related to IndexStatistics and query filter combination logic.

Need More Details?

View the full release notes and all changes for LanceDB v0.31.0.

View Full Changelog