Skip to content

Commit c68da22

Browse files
authored
Update and lint release notes (#3699)
1 parent 8680d88 commit c68da22

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

release-notes/7.0/7.0.0-preview2.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -40,19 +40,24 @@ This update brings the following changes since the [7.0.0-preview1](7.0.0-previe
4040

4141
- If your environment might be affected (i.e., you operate a BAG with custom ports, or have experienced failures after failover), you can enable the new switch in your application:
4242

43-
```
43+
```c#
4444
AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner", true);
4545
```
4646

4747
- Then, ensure your connection string includes your preferred failover partner (with correct `tcp:host,port`) so that the client uses that instead of the server's suggestion.
4848
- Without enabling this, by default, the client continues to prefer the server-provided partner, maintaining backwards compatibility.
4949

50-
5150
#### Other Additions
5251

5352
- Add app context switch for enabling asynchronous multi-packet improvements
5453
([#3605](https://github.com/dotnet/SqlClient/pull/3605))
5554

55+
To enable these improvements, set the following switches in your application:
56+
57+
```c#
58+
AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseCompatibilityAsyncBehaviour", false);
59+
AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseCompatibilityProcessSni", false);
60+
```
5661

5762
### Changed
5863

@@ -64,7 +69,7 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailov
6469

6570
*Who benefits:*
6671

67-
- Teams moving toward stronger, passwordless or MFA-compliant auth (in line with changes across MSAL/Azure.Identity and Entra MFA enforcement). This aligns Microsoft.Data.SqlClient with Microsoft's direction to avoid username/password (ROPC) flows. See https://learn.microsoft.com/en-us/entra/identity/authentication/concept-mandatory-multifactor-authentication for more explanation of why this change is being made across Microsoft products/services.
72+
- Teams moving toward stronger, passwordless or MFA-compliant auth (in line with changes across MSAL/Azure.Identity and Entra MFA enforcement). This aligns Microsoft.Data.SqlClient with Microsoft's direction to avoid username/password (ROPC) flows. See [Planning for mandatory multifactor authentication for Azure and other admin portals](https://learn.microsoft.com/entra/identity/authentication/concept-mandatory-multifactor-authentication) for more explanation of why this change is being made across Microsoft products/services.
6873

6974
*Impact:*
7075

@@ -73,11 +78,11 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailov
7378
- Service to service: `Active Directory Service Principal` (client secret/certificate)
7479
- Cloud workloads: `Active Directory Managed Identity` or `Active Directory Workload Identity`
7580
- Headless/Developer flows: `Active Directory Device Code Flow` or `Active Directory Default`
76-
- See https://learn.microsoft.com/en-us/sql/connect/ado-net/sql/azure-active-directory-authentication for more information on authentication to SQL Server using Microsoft Entra.
81+
- See [Connect to Azure SQL with Microsoft Entra authentication and SqlClient](https://learn.microsoft.com/sql/connect/ado-net/sql/azure-active-directory-authentication) for more information on authentication to SQL Server using Microsoft Entra.
7782

7883
#### Other changes
7984

80-
- Improve performance in `SqlStatistics` by using `Environment.TickCount` for calculating execution timing
85+
- Improve performance in `SqlStatistics` by using `Environment.TickCount` for calculating execution timing
8186
([#3609](https://github.com/dotnet/SqlClient/pull/3609))
8287

8388
- Improve performance in Always Encrypted scenarios by using lower-allocation primitives
@@ -131,6 +136,7 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailov
131136
- Updated `System.Text.Json` to v8.0.6 (net8), v9.0.9 (net9)
132137

133138
## Contributors
139+
134140
We thank the following public contributors. Their efforts toward this project are very much appreciated.
135141

136142
- [edwardneal](https://github.com/edwardneal)

0 commit comments

Comments
 (0)