Skip to content

Document: vector properties not loaded by default in EF Core 11#5286

Merged
roji merged 5 commits into
preview-3from
copilot/document-efcore-pull-37857
Mar 10, 2026
Merged

Document: vector properties not loaded by default in EF Core 11#5286
roji merged 5 commits into
preview-3from
copilot/document-efcore-pull-37857

Conversation

Copilot AI commented Mar 7, 2026

Copy link
Copy Markdown
Contributor

EF Core 11 introduces partial property loading: SqlVector<T> properties are excluded from SELECT by default, since vectors are large and rarely need to be read back after ingestion.

vector-search.md

  • Added a [!NOTE] noting that prior to EF Core 11, vector properties were always loaded like any other property
  • Updated SQL snippets in VECTOR_SEARCH() and hybrid search examples to reflect vector column no longer appearing in SELECT

whatsnew.md

  • Added brief "Vector properties not loaded by default" entry under the SQL Server section with a minimal code example showing that vector columns are excluded from entity projections but can still be used in filters and orderings

breaking-changes.md

  • Added a low-impact breaking change entry for SqlVector<T> properties no longer being loaded by default (tracking issue #37279)
  • Mitigations section notes that an opt-in mechanism will be introduced later in the EF Core 11 release, and documents explicit projection as a workaround in the meantime

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Document dotnet/efcore#37279

Co-authored-by: roji <1862641+roji@users.noreply.github.com>
Copilot AI changed the title [WIP] Document changes in EF Core pull request 37857 Document: vector properties not loaded by default in EF Core 11 Mar 7, 2026
Copilot finished work on behalf of roji March 7, 2026 08:44
Comment thread entity-framework/core/providers/sql-server/vector-search.md Outdated
Comment thread entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md Outdated
Comment thread entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md Outdated
Co-authored-by: roji <1862641+roji@users.noreply.github.com>
Copilot finished work on behalf of roji March 7, 2026 08:52

@roji roji left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Add a low-impact breaking change note. For now, leave the "mitigation" section as TODO - we'll be introducing a mechanism to opt into loading vector properties later in the release.

Co-authored-by: roji <1862641+roji@users.noreply.github.com>

Copilot AI commented Mar 7, 2026

Copy link
Copy Markdown
Contributor Author

Add a low-impact breaking change note. For now, leave the "mitigation" section as TODO - we'll be introducing a mechanism to opt into loading vector properties later in the release.

Done in dc55ed9 — added a low-impact breaking change entry in breaking-changes.md for SqlVector<T> properties no longer being loaded by default (tracking issue #37279). The Mitigations section includes a [!NOTE] placeholder explaining that an opt-in mechanism will be introduced later in the EF Core 11 release, along with an explicit-projection workaround in the meantime.

Copilot finished work on behalf of roji March 7, 2026 09:22
@roji
roji marked this pull request as ready for review March 7, 2026 16:44
@AndriySvyryd
AndriySvyryd requested a review from Copilot March 10, 2026 20:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Documents an EF Core 11 behavior change for SQL Server vector columns (SqlVector<T>): vector properties are excluded from entity materialization by default to avoid transferring large payloads unnecessarily.

Changes:

  • Added a “Vector properties not loaded by default” note/section in EF Core 11 “What’s New”.
  • Added a low-impact breaking change entry describing the new default behavior and mitigations.
  • Updated SQL examples in the SQL Server vector search docs to reflect the new default projection.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md Adds a SQL Server “What’s New” entry explaining default non-loading of vector properties with a short example.
entity-framework/core/what-is-new/ef-core-11.0/breaking-changes.md Adds a low-impact breaking change entry for SqlVector<T> not being loaded by default and a projection-based mitigation.
entity-framework/core/providers/sql-server/vector-search.md Adds a note about the new default behavior and updates SQL snippets to omit vector columns from entity projections.

You can also share your feedback on Copilot code review. Take the survey.

Comment thread entity-framework/core/what-is-new/ef-core-11.0/whatsnew.md Outdated
Comment thread entity-framework/core/providers/sql-server/vector-search.md Outdated
Comment thread entity-framework/core/what-is-new/ef-core-11.0/breaking-changes.md Outdated
@roji
roji merged commit eb201bd into preview-3 Mar 10, 2026
5 checks passed
@roji
roji deleted the copilot/document-efcore-pull-37857 branch March 10, 2026 22:15
roji added a commit that referenced this pull request Mar 10, 2026
roji added a commit that referenced this pull request Apr 14, 2026
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.

4 participants