Skip to content

Commit 912ff99

Browse files
Document SqlClient 6.1.6 dependency size impact in EF Core 10 (#5486)
Co-authored-by: AndriySvyryd <6539701+AndriySvyryd@users.noreply.github.com>
1 parent d74e5b4 commit 912ff99

1 file changed

Lines changed: 23 additions & 0 deletions

File tree

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

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ This page documents API and behavior changes that have the potential to break ex
2323
| **Breaking change** | **Impact** |
2424
|:--------------------------------------------------------------------------------------------------------------- | -----------|
2525
| [EF tools now require framework to be specified for multi-targeted projects](#ef-tools-multi-targeting) | Medium |
26+
| [SQL Server: Microsoft.Data.SqlClient adds a broker dependency](#sqlclient-broker-dependency) | Low |
2627
| [Application Name is now injected into the connection string](#sqlserver-application-name) | Low |
2728
| [SQL Server json data type used by default on Azure SQL and compatibility level 170](#sqlserver-json-data-type) | Low |
2829
| [Parameterized collections now use multiple parameters by default](#parameterized-collections) | Low |
@@ -83,6 +84,28 @@ You'll need to choose one of the frameworks (e.g., `net9.0`) when running the EF
8384

8485
## Low-impact changes
8586

87+
<a name="sqlclient-broker-dependency"></a>
88+
89+
### SQL Server: Microsoft.Data.SqlClient adds a broker dependency
90+
91+
#### Old behavior
92+
93+
Earlier versions of Microsoft.Data.SqlClient did not depend on Microsoft.Identity.Client.Broker.
94+
95+
#### New behavior
96+
97+
Microsoft.Data.SqlClient 6.1.6 introduces a dependency on Microsoft.Identity.Client.Broker, which is required for Microsoft Entra ID authentication and can drastically increase the size of the published application when using the EF Core SQL Server provider.
98+
99+
#### Why
100+
101+
The additional dependency is introduced by Microsoft.Data.SqlClient, rather than EF Core itself.
102+
103+
#### Mitigations
104+
105+
If your application doesn't use Microsoft Entra ID authentication, explicitly reference Microsoft.Data.SqlClient 7.1.x in your project to override the version used by EF Core. Starting with version 7.0, Microsoft.Data.SqlClient no longer includes Azure/Entra ID authentication dependencies in its core package.
106+
107+
For details, including the additional package required for Entra ID authentication, see [Microsoft.Data.SqlClient has been updated to 7.0](xref:core/what-is-new/ef-core-11.0/breaking-changes#sqlclient-7).
108+
86109
<a name="sqlserver-application-name"></a>
87110

88111
### Application Name is now injected into the connection string

0 commit comments

Comments
 (0)