|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## Stable Release 6.1.3 - 2025-11-12 |
| 4 | + |
| 5 | +This update includes the following changes since the [6.1.2](6.1.2.md) release: |
| 6 | + |
| 7 | +### Added |
| 8 | + |
| 9 | +#### App Context Switch for Ignoring Server-Provided Failover Partner |
| 10 | + |
| 11 | +*What Changed:* |
| 12 | + |
| 13 | +- 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 [#3702](https://github.com/dotnet/SqlClient/pull/3702). |
| 14 | + |
| 15 | +*Who Benefits:* |
| 16 | + |
| 17 | +- 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. |
| 18 | +- Teams who manage availability groups and rely on client-side control of failover behavior in heterogeneous networking environments. |
| 19 | + |
| 20 | +*Impact:* |
| 21 | + |
| 22 | +- 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: |
| 23 | + |
| 24 | +```c# |
| 25 | +AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.IgnoreServerProvidedFailoverPartner", true); |
| 26 | +``` |
| 27 | + |
| 28 | +- 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. |
| 29 | +- Without enabling this, by default, the client continues to prefer the server-provided partner, maintaining backwards compatibility. |
| 30 | + |
| 31 | +### Fixed |
| 32 | + |
| 33 | +- Fixed an issue to ensure reliable metrics initialization during startup, |
| 34 | + preventing missed telemetry when EventSource is enabled early. |
| 35 | + ([#3718](https://github.com/dotnet/SqlClient/pull/3718)) |
| 36 | + |
| 37 | +## Target Platform Support |
| 38 | + |
| 39 | +- .NET Framework 4.6.2+ (Windows ARM64, Windows x86, Windows x64) |
| 40 | +- .NET 8.0+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS) |
| 41 | + |
| 42 | +### Dependencies |
| 43 | + |
| 44 | +#### .NET Framework 4.6.2+ |
| 45 | + |
| 46 | +- Azure.Core 1.47.1 |
| 47 | +- Azure.Identity 1.14.2 |
| 48 | +- Microsoft.Bcl.Cryptography 8.0.0 |
| 49 | +- Microsoft.Data.SqlClient.SNI 6.0.2 |
| 50 | +- Microsoft.Extensions.Caching.Memory 8.0.1 |
| 51 | +- Microsoft.IdentityModel.JsonWebTokens 7.7.1 |
| 52 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 7.7.1 |
| 53 | +- System.Buffers 4.5.1 |
| 54 | +- System.Data.Common 4.3.0 |
| 55 | +- System.Security.Cryptography.Pkcs 8.0.1 |
| 56 | +- System.Text.Encodings.Web 8.0.0 |
| 57 | +- System.Text.Json 8.0.5 |
| 58 | + |
| 59 | +#### .NET 8.0 |
| 60 | + |
| 61 | +- Azure.Core 1.47.1 |
| 62 | +- Azure.Identity 1.14.2 |
| 63 | +- Microsoft.Bcl.Cryptography 8.0.0 |
| 64 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 65 | +- Microsoft.Extensions.Caching.Memory 8.0.1 |
| 66 | +- Microsoft.IdentityModel.JsonWebTokens 7.7.1 |
| 67 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 7.7.1 |
| 68 | +- Microsoft.SqlServer.Server 1.0.0 |
| 69 | +- System.Configuration.ConfigurationManager 8.0.1 |
| 70 | +- System.Security.Cryptography.Pkcs 8.0.1 |
| 71 | +- System.Text.Json 8.0.5 |
| 72 | + |
| 73 | +#### .NET 9.0 |
| 74 | + |
| 75 | +- Azure.Core 1.47.1 |
| 76 | +- Azure.Identity 1.14.2 |
| 77 | +- Microsoft.Bcl.Cryptography 9.0.5 |
| 78 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 79 | +- Microsoft.Extensions.Caching.Memory 9.0.5 |
| 80 | +- Microsoft.IdentityModel.JsonWebTokens 7.7.1 |
| 81 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 7.7.1 |
| 82 | +- Microsoft.SqlServer.Server 1.0.0 |
| 83 | +- System.Configuration.ConfigurationManager 9.0.5 |
| 84 | +- System.Security.Cryptography.Pkcs 9.0.5 |
| 85 | +- System.Text.Json 9.0.5 |
| 86 | + |
| 87 | +#### .NET Standard 2.0 |
| 88 | + |
| 89 | +- Azure.Core 1.47.1 |
| 90 | +- Azure.Identity 1.14.2 |
| 91 | +- Microsoft.Bcl.Cryptography 8.0.0 |
| 92 | +- Microsoft.Data.SqlClient.SNI.runtime 6.0.2 |
| 93 | +- Microsoft.Extensions.Caching.Memory 8.0.1 |
| 94 | +- Microsoft.IdentityModel.JsonWebTokens 7.7.1 |
| 95 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 7.7.1 |
| 96 | +- Microsoft.SqlServer.Server 1.0.0 |
| 97 | +- System.Configuration.ConfigurationManager 8.0.1 |
| 98 | +- System.Security.Cryptography.Pkcs 8.0.1 |
| 99 | +- System.Text.Json 8.0.5 |
0 commit comments