Skip to content

Commit aa58379

Browse files
Copilotroji
andcommitted
Bump SqlClient 7.0 breaking change to Medium impact and fix table alignment
Co-authored-by: roji <1862641+roji@users.noreply.github.com> Agent-Logs-Url: https://github.com/dotnet/EntityFramework.Docs/sessions/44b3dc70-6a2c-4517-995b-3ec5d23ff6ff
1 parent 9e104e3 commit aa58379

1 file changed

Lines changed: 31 additions & 31 deletions

File tree

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

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -19,12 +19,12 @@ This page documents API and behavior changes that have the potential to break ex
1919
| **Breaking change** | **Impact** |
2020
|:--------------------------------------------------------------------------------------------------------------- | -----------|
2121
| [Sync I/O via the Azure Cosmos DB provider has been fully removed](#cosmos-nosync) | Medium |
22+
| [Microsoft.Data.SqlClient has been updated to 7.0](#sqlclient-7) | Medium |
2223
| [EF Core now throws by default when no migrations are found](#migrations-not-found) | Low |
2324
| [`EFOptimizeContext` MSBuild property has been removed](#ef-optimize-context-removed) | Low |
2425
| [EF tools packages no longer reference Microsoft.EntityFrameworkCore.Design](#ef-tools-no-design-dep) | Low |
2526
| [SqlVector properties are no longer loaded by default](#sqlvector-not-auto-loaded) | Low |
2627
| [Cosmos: empty owned collections now return an empty collection instead of null](#cosmos-empty-collections) | Low |
27-
| [Microsoft.Data.SqlClient has been updated to 7.0](#sqlclient-7) | Low |
2828

2929
## Medium-impact changes
3030

@@ -50,6 +50,36 @@ Synchronous blocking on asynchronous methods ("sync-over-async") is highly disco
5050

5151
Convert your code to use async I/O APIs instead of sync I/O ones. For example, replace calls to `SaveChanges()` with `await SaveChangesAsync()`.
5252

53+
<a name="sqlclient-7"></a>
54+
55+
### Microsoft.Data.SqlClient has been updated to 7.0
56+
57+
#### Old behavior
58+
59+
EF Core 10 used [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 6.x, which included Azure/Entra ID authentication dependencies (such as `Azure.Core`, `Azure.Identity`, and `Microsoft.Identity.Client`) in the core package.
60+
61+
#### New behavior
62+
63+
EF Core 11 now depends on [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 7.0. This version removes Azure/Entra ID (formerly Azure Active Directory) authentication dependencies from the core package. If your application uses Entra ID authentication (for example, `ActiveDirectoryDefault`, `ActiveDirectoryInteractive`, `ActiveDirectoryManagedIdentity`, or `ActiveDirectoryServicePrincipal`), you must now install the [`Microsoft.Data.SqlClient.Extensions.Azure`](https://www.nuget.org/packages/Microsoft.Data.SqlClient.Extensions.Azure/) package separately.
64+
65+
In addition, `SqlAuthenticationMethod.ActiveDirectoryPassword` has been marked as obsolete.
66+
67+
For more details, see the [Microsoft.Data.SqlClient 7.0 release notes](https://github.com/dotnet/SqlClient/blob/main/release-notes/7.0/7.0.0.md).
68+
69+
#### Why
70+
71+
This change was made in [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) to reduce dependency bloat for applications that don't use Azure authentication, which is especially beneficial for containerized deployments and local development.
72+
73+
#### Mitigations
74+
75+
If your application uses Entra ID authentication with SQL Server, add a reference to the `Microsoft.Data.SqlClient.Extensions.Azure` package in your project:
76+
77+
```xml
78+
<PackageReference Include="Microsoft.Data.SqlClient.Extensions.Azure" Version="7.0.0" />
79+
```
80+
81+
No code changes are required beyond adding this package reference. If you use `SqlAuthenticationMethod.ActiveDirectoryPassword`, migrate to a modern authentication method such as `ActiveDirectoryDefault` or `ActiveDirectoryInteractive`.
82+
5383
## Low-impact changes
5484

5585
<a name="migrations-not-found"></a>
@@ -213,33 +243,3 @@ if (entity.OwnedCollection is { Count: 0 })
213243
// treated as empty
214244
}
215245
```
216-
217-
<a name="sqlclient-7"></a>
218-
219-
### Microsoft.Data.SqlClient has been updated to 7.0
220-
221-
#### Old behavior
222-
223-
EF Core 10 used [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 6.x, which included Azure/Entra ID authentication dependencies (such as `Azure.Core`, `Azure.Identity`, and `Microsoft.Identity.Client`) in the core package.
224-
225-
#### New behavior
226-
227-
EF Core 11 now depends on [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) 7.0. This version removes Azure/Entra ID (formerly Azure Active Directory) authentication dependencies from the core package. If your application uses Entra ID authentication (for example, `ActiveDirectoryDefault`, `ActiveDirectoryInteractive`, `ActiveDirectoryManagedIdentity`, or `ActiveDirectoryServicePrincipal`), you must now install the [`Microsoft.Data.SqlClient.Extensions.Azure`](https://www.nuget.org/packages/Microsoft.Data.SqlClient.Extensions.Azure/) package separately.
228-
229-
In addition, `SqlAuthenticationMethod.ActiveDirectoryPassword` has been marked as obsolete.
230-
231-
For more details, see the [Microsoft.Data.SqlClient 7.0 release notes](https://github.com/dotnet/SqlClient/blob/main/release-notes/7.0/7.0.0.md).
232-
233-
#### Why
234-
235-
This change was made in [Microsoft.Data.SqlClient](https://www.nuget.org/packages/Microsoft.Data.SqlClient/) to reduce dependency bloat for applications that don't use Azure authentication, which is especially beneficial for containerized deployments and local development.
236-
237-
#### Mitigations
238-
239-
If your application uses Entra ID authentication with SQL Server, add a reference to the `Microsoft.Data.SqlClient.Extensions.Azure` package in your project:
240-
241-
```xml
242-
<PackageReference Include="Microsoft.Data.SqlClient.Extensions.Azure" Version="7.0.0" />
243-
```
244-
245-
No code changes are required beyond adding this package reference. If you use `SqlAuthenticationMethod.ActiveDirectoryPassword`, migrate to a modern authentication method such as `ActiveDirectoryDefault` or `ActiveDirectoryInteractive`.

0 commit comments

Comments
 (0)