Skip to content

docs: document scalar indexing on nested struct fields#249

Merged
prrao87 merged 3 commits into
mainfrom
docs/nested-index-field-paths
May 29, 2026
Merged

docs: document scalar indexing on nested struct fields#249
prrao87 merged 3 commits into
mainfrom
docs/nested-index-field-paths

Conversation

@mintlify

@mintlify mintlify Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor

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

mintlify Bot commented May 20, 2026

Copy link
Copy Markdown
Contributor Author

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

@prrao87
prrao87 merged commit 8725457 into main May 29, 2026
2 checks passed
@prrao87
prrao87 deleted the docs/nested-index-field-paths branch May 29, 2026 19:20
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.

1 participant