Skip to content

docs: document scalar indexing on nested struct fields#249

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
docs/nested-index-field-paths
Open

docs: document scalar indexing on nested struct fields#249
mintlify[bot] wants to merge 1 commit into
mainfrom
docs/nested-index-field-paths

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 20, 2026

Summary

Document how to build scalar indexes on fields nested inside struct columns, including how to escape literal dots in field names.

Changes

  • Add an "Index nested fields" section to the Scalar Index page covering create_index with dot-separated paths (e.g. metadata.user_id) and backtick-escaped segments (e.g. metadata.`user.id`).
  • Show that list_indices() returns the canonical path you passed in, so nested indexes round-trip through index metadata.
  • Note that composite (multi-column) indexes still aren't supported.

Context

Upstream fix makes index metadata APIs return canonical Lance field paths instead of leaf names, so nested indexes such as metadata.user_id and escaped literal-dot fields now round-trip through list_indices(). Native index creation also canonicalizes the input path before handing it to Lance, keeping local metadata consistent with the field-path contract.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 20, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lancedb-bcbb4faf 🟢 Ready View Preview May 20, 2026, 7:02 AM

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.

0 participants