|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## Preview Release 7.0.0-preview2.25289.6 - 2025-10-16 |
| 4 | + |
| 5 | +## Changes Since [7.0.0-preview1](7.0.0-preview1.md) |
| 6 | + |
| 7 | +This update brings the following changes since the [7.0.0-preview1](7.0.0-preview1.md) release: |
| 8 | + |
| 9 | +### Bug Fixes |
| 10 | + |
| 11 | +- Fixed a debug assertion in connection pool (no impact to production code) |
| 12 | + ([#3587](https://github.com/dotnet/SqlClient/pull/3587)) |
| 13 | + |
| 14 | +- Prevent uninitialized performance counters escaping `CreatePerformanceCounters` |
| 15 | + ([#3623](https://github.com/dotnet/SqlClient/pull/3623)) |
| 16 | + |
| 17 | +- Fix SetProvider to return immediately if user-defined authentication provider found |
| 18 | + ([#3620](https://github.com/dotnet/SqlClient/pull/3620)) |
| 19 | + |
| 20 | +- Allow SqlBulkCopy to operate on hidden columns |
| 21 | + ([#3590](https://github.com/dotnet/SqlClient/pull/3590)) |
| 22 | + |
| 23 | +- Fix connection pool concurrency issue |
| 24 | + ([#3632](https://github.com/dotnet/SqlClient/pull/3632)) |
| 25 | + |
| 26 | +### Added |
| 27 | + |
| 28 | +#### App Context Switch for Ignoring Server-Provided Failover Partner |
| 29 | + |
| 30 | +*What Changed:* |
| 31 | + |
| 32 | +- A new app context switch `Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner` was introduced to let the client ignore server-provided failover partner info in Basic Availability Groups (BAGs). When the switch is enabled, only the failover partner specified in the connection string is used; server-supplied partner values are skipped. This context switch was introduced in PR [#3625](https://github.com/dotnet/SqlClient/pull/3625). |
| 33 | + |
| 34 | +*Who Benefits:* |
| 35 | + |
| 36 | +- Applications connecting to SQL Server BAGs using TCP and custom ports, especially where the server's provided partner name lacks the protocol, host, or port. This avoids connection failures when the server-provided partner is incompatible or incomplete. |
| 37 | +- Teams who manage availability groups and rely on client-side control of failover behavior in heterogeneous networking environments. |
| 38 | + |
| 39 | +*Impact:* |
| 40 | + |
| 41 | +- 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: |
| 42 | + |
| 43 | +``` |
| 44 | +AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner", true); |
| 45 | +``` |
| 46 | + |
| 47 | +- 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. |
| 48 | +- Without enabling this, by default, the client continues to prefer the server-provided partner, maintaining backwards compatibility. |
| 49 | + |
| 50 | + |
| 51 | +#### Other Additions |
| 52 | + |
| 53 | +- Add app context switch for enabling asynchronous multi-packet improvements |
| 54 | + ([#3605](https://github.com/dotnet/SqlClient/pull/3605)) |
| 55 | + |
| 56 | + |
| 57 | +### Changed |
| 58 | + |
| 59 | +#### Deprecation of `SqlAuthenticationMethod.ActiveDirectoryPassword` |
| 60 | + |
| 61 | +*What Changed:* |
| 62 | + |
| 63 | +- Username/Password authentication for Microsoft Entra (formerly Active Directory) has been deprecated. `SqlAuthenticationMethod.ActiveDirectoryPassword` is now marked as `[Obsolete]`. This change occurred in PR [#3671](https://github.com/dotnet/SqlClient/pull/3671) |
| 64 | + |
| 65 | +*Who benefits:* |
| 66 | + |
| 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. |
| 68 | + |
| 69 | +*Impact:* |
| 70 | + |
| 71 | +- If you use `Authentication=Active Directory Password`, migrate to a supported alternative: |
| 72 | + - Interactive/MFA: `Active Directory Interactive` |
| 73 | + - Service to service: `Active Directory Service Principal` (client secret/certificate) |
| 74 | + - Cloud workloads: `Active Directory Managed Identity` or `Active Directory Workload Identity` |
| 75 | + - 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. |
| 77 | + |
| 78 | +#### Other changes |
| 79 | + |
| 80 | +- Improve performance in `SqlStatistics` by using `Environment.TickCount` for calculating execution timing |
| 81 | + ([#3609](https://github.com/dotnet/SqlClient/pull/3609)) |
| 82 | + |
| 83 | +- Improve performance in Always Encrypted scenarios by using lower-allocation primitives |
| 84 | + ([#3612](https://github.com/dotnet/SqlClient/pull/3612)) |
| 85 | + |
| 86 | +- Various test improvements: |
| 87 | + ([#3423](https://github.com/dotnet/SqlClient/pull/3423), |
| 88 | + [#3488](https://github.com/dotnet/SqlClient/pull/3488), |
| 89 | + [#3624](https://github.com/dotnet/SqlClient/pull/3624), |
| 90 | + [#3638](https://github.com/dotnet/SqlClient/pull/3638), |
| 91 | + [#3642](https://github.com/dotnet/SqlClient/pull/3642), |
| 92 | + [#3678](https://github.com/dotnet/SqlClient/pull/3678), |
| 93 | + [#3690](https://github.com/dotnet/SqlClient/pull/3690)) |
| 94 | + |
| 95 | +- Codebase merge project and related cleanup: |
| 96 | + ([#3555](https://github.com/dotnet/SqlClient/pull/3555), |
| 97 | + [#3603](https://github.com/dotnet/SqlClient/pull/3603), |
| 98 | + [#3608](https://github.com/dotnet/SqlClient/pull/3608), |
| 99 | + [#3611](https://github.com/dotnet/SqlClient/pull/3611), |
| 100 | + [#3619](https://github.com/dotnet/SqlClient/pull/3619), |
| 101 | + [#3622](https://github.com/dotnet/SqlClient/pull/3622), |
| 102 | + [#3630](https://github.com/dotnet/SqlClient/pull/3630), |
| 103 | + [#3631](https://github.com/dotnet/SqlClient/pull/3631), |
| 104 | + [#3634](https://github.com/dotnet/SqlClient/pull/3634), |
| 105 | + [#3637](https://github.com/dotnet/SqlClient/pull/3637), |
| 106 | + [#3644](https://github.com/dotnet/SqlClient/pull/3644), |
| 107 | + [#3647](https://github.com/dotnet/SqlClient/pull/3647), |
| 108 | + [#3655](https://github.com/dotnet/SqlClient/pull/3655)) |
| 109 | + |
| 110 | +- Code health improvements: |
| 111 | + ([#3645](https://github.com/dotnet/SqlClient/pull/3645)) |
| 112 | + |
| 113 | +- Internal infrastructure improvements: |
| 114 | + ([#3659](https://github.com/dotnet/SqlClient/pull/3659), |
| 115 | + [#3692](https://github.com/dotnet/SqlClient/pull/3692), |
| 116 | + [#3695](https://github.com/dotnet/SqlClient/pull/3695)) |
| 117 | + |
| 118 | +- Updated Dependencies |
| 119 | + ([#3638](https://github.com/dotnet/SqlClient/pull/3638)): |
| 120 | + - Updated `Azure.Core` to v1.49.0 |
| 121 | + - Updated `Azure.Identity` to v1.16.0 |
| 122 | + - Updated `Azure.Security.KeyVault.Keys` v4.8.0 (AKV provider) |
| 123 | + - Updated `Microsoft.Bcl.Cryptography` to v9.0.9 (net9) |
| 124 | + - Updated `Microsoft.Extensions.Caching.Memory` to v9.0.9 (net9) |
| 125 | + - Updated `Microsoft.IdentityModel.JsonWebTokens` to v8.14.0 |
| 126 | + - Updated `Microsoft.IdentityModel.Protocols.OpenIdConnect` to v8.14.0 |
| 127 | + - Updated `System.Buffers` to v4.6.1 (net462) |
| 128 | + - Updated `System.Memory` to v4.6.3 (net462) |
| 129 | + - Updated `System.Configuration.ConfigurationManager` to v9.0.9 (net9) |
| 130 | + - Updated `System.Security.Cryptography.Pkcs` to v9.0.9 (net9) |
| 131 | + - Updated `System.Text.Json` to v8.0.6 (net8), v9.0.9 (net9) |
| 132 | + |
| 133 | +## Contributors |
| 134 | +We thank the following public contributors. Their efforts toward this project are very much appreciated. |
| 135 | + |
| 136 | +- [edwardneal](https://github.com/edwardneal) |
| 137 | +- [ShreyaLaxminarayan](https://github.com/ShreyaLaxminarayan) |
| 138 | +- [Wraith2](https://github.com/Wraith2) |
| 139 | + |
| 140 | +## Target Platform Support |
| 141 | + |
| 142 | +- .NET Framework 4.6.2+ (Windows x86, Windows x64, Windows ARM64) |
| 143 | +- .NET 8.0+ (Windows x86, Windows x64, Windows ARM, Windows ARM64, Linux, macOS) |
| 144 | + |
| 145 | +### Dependencies |
| 146 | + |
| 147 | +#### .NET Standard 2.0 |
| 148 | + |
| 149 | +- Azure.Core 1.49.0 |
| 150 | +- Azure.Identity 1.16.0 |
| 151 | +- Microsoft.Bcl.Cryptography 9.0.9 |
| 152 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 153 | +- Microsoft.Extensions.Caching.Memory 9.0.9 |
| 154 | +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 |
| 155 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 |
| 156 | +- Microsoft.SqlServer.Server 1.0.0 |
| 157 | +- System.Configuration.ConfigurationManager 9.0.9 |
| 158 | +- System.Security.Cryptography.Pkcs 9.0.5 |
| 159 | +- System.Text.Json 9.0.9 |
| 160 | + |
| 161 | +#### .NET Framework 4.6.2+ |
| 162 | + |
| 163 | +- Azure.Core 1.49.0 |
| 164 | +- Azure.Identity 1.16.0 |
| 165 | +- Microsoft.Bcl.Cryptography 8.0.0 |
| 166 | +- Microsoft.Data.SqlClient.SNI 6.0.2 |
| 167 | +- Microsoft.Extensions.Caching.Memory 8.0.1 |
| 168 | +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 |
| 169 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 7.7.1 |
| 170 | +- System.Buffers 4.6.1 |
| 171 | +- System.Data.Common 4.3.0 |
| 172 | +- System.Diagnostics.DiagnosticSource 8.0.1 |
| 173 | +- System.Memory 4.6.3 |
| 174 | +- System.Security.Cryptography.Pkcs 8.0.1 |
| 175 | +- System.Text.Encodings.Web 8.0.0 |
| 176 | +- System.Text.Json 8.0.6 |
| 177 | +- System.ValueTuple 4.6.1 |
| 178 | + |
| 179 | +#### .NET 8.0 |
| 180 | + |
| 181 | +- Azure.Core 1.49.0 |
| 182 | +- Azure.Identity 1.16.0 |
| 183 | +- Microsoft.Bcl.Cryptography 9.0.9 |
| 184 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 185 | +- Microsoft.Extensions.Caching.Memory 9.0.9 |
| 186 | +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 |
| 187 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 |
| 188 | +- Microsoft.SqlServer.Server 1.0.0 |
| 189 | +- System.Configuration.ConfigurationManager 9.0.9 |
| 190 | +- System.Security.Cryptography.Pkcs 9.0.5 |
| 191 | +- System.Text.Json 9.0.9 |
| 192 | + |
| 193 | +#### .NET 9.0 |
| 194 | + |
| 195 | +- Azure.Core 1.49.0 |
| 196 | +- Azure.Identity 1.16.0 |
| 197 | +- Microsoft.Bcl.Cryptography 9.0.9 |
| 198 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 199 | +- Microsoft.Extensions.Caching.Memory 9.0.9 |
| 200 | +- Microsoft.IdentityModel.JsonWebTokens 8.14.0 |
| 201 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 8.14.0 |
| 202 | +- Microsoft.SqlServer.Server 1.0.0 |
| 203 | +- System.Configuration.ConfigurationManager 9.0.9 |
| 204 | +- System.Security.Cryptography.Pkcs 9.0.9 |
| 205 | +- System.Text.Json 9.0.9 |
0 commit comments