Skip to content

Commit 52de3e4

Browse files
Copilotroji
andauthored
Document parameterized collection translation as breaking change in EF Core 10 (#5224)
Co-authored-by: roji <1862641+roji@users.noreply.github.com>
1 parent d044fcc commit 52de3e4

1 file changed

Lines changed: 7 additions & 0 deletions

File tree

entity-framework/core/what-is-new/ef-core-10.0/breaking-changes.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,13 @@ The new default translation provides the query planner with cardinality informat
227227

228228
However, different workloads may benefit from different translation strategies depending on collection sizes, query patterns, and database characteristics.
229229

230+
> [!NOTE]
231+
> While the new default translation will not cause any behavioral change or performance regression in the majority of cases, the change in how queries are translated to SQL may have adverse consequences in some scenarios.
232+
>
233+
> Applications that were built with EF Core 8 or 9, and rely on the performance characteristics of the JSON array parameter translation (using `OPENJSON` or similar database-specific functions) may experience performance differences when upgrading to EF Core 10. This is especially relevant for queries with large collections or specific query patterns that benefited from the previous translation strategy.
234+
>
235+
> If you experience performance regressions after upgrading, consider using the mitigation strategies below to revert to the previous behavior globally or for specific queries.
236+
230237
#### Mitigations
231238

232239
If you encounter issues with the new default behavior (such as performance regressions), you can configure the translation mode globally:

0 commit comments

Comments
 (0)