|
| 1 | +# Release Notes |
| 2 | + |
| 3 | +## Microsoft.Data.SqlClient 5.0.0-preview3 released 16 June 2022 |
| 4 | + |
| 5 | +This update brings the below changes over the previous release: |
| 6 | + |
| 7 | +### Added |
| 8 | + |
| 9 | +- Added support for `TDS 8`. To use TDS 8, users should specify Encrypt=Strict in the connection string. [#1608](https://github.com/dotnet/SqlClient/pull/1608) [Read more](#tds-8-enhanced-security) |
| 10 | +- Added support for specifying Server SPN and Failover Server SPN on the connection. [#1607](https://github.com/dotnet/SqlClient/pull/1607) [Read more](#server-spn) |
| 11 | +- Added support for aliases when targeting .NET Core on Windows. [#1588](https://github.com/dotnet/SqlClient/pull/1588) [Read more](#support-for-aliases) |
| 12 | + |
| 13 | +### Fixed |
| 14 | + |
| 15 | +- Fixed naming, order, and formatting for `SqlDiagnosticsListener` on .NET Core and .NET. [#1637] (https://github.com/dotnet/SqlClient/pull/1637) |
| 16 | +- Fixed NullReferenceException during Azure Active Directory authentication. [#1625] (https://github.com/dotnet/SqlClient/pull/1625) |
| 17 | +- Added CommandText length validation when using stored procedure command types. [#1484](https://github.com/dotnet/SqlClient/pull/1484) |
| 18 | +- Fixed `GetSchema("StructuredTypeMembers")` to return correct schema information. [#1500] (https://github.com/dotnet/SqlClient/pull/1500), [#1639](https://github.com/dotnet/SqlClient/pull/1639) |
| 19 | +- Fixed NullReferenceException when using `SqlDependency.Start` against an Azure SQL Database.[#1294] (https://github.com/dotnet/SqlClient/pull/1294) |
| 20 | +- Send the correct retained transaction descriptor in the MARS TDS Header when there is no current transaction on .NET 5+ and .NET Core. [#1624] (https://github.com/dotnet/SqlClient/pull/1624) |
| 21 | +- Parallelize SSRP requests on Linux and macOS when MultiSubNetFailover is specified. [#1578] (https://github.com/dotnet/SqlClient/pull/1578) |
| 22 | +- Adjust the default ConnectRetryCount against Azure Synapse OnDemand endpoints [#1626] (https://github.com/dotnet/SqlClient/pull/1626) |
| 23 | + |
| 24 | +### Changed |
| 25 | + |
| 26 | +- Dropped the `Microsoft.Data.SqlClient.Server` namespace and replaced it with supported types from the [Microsoft.SqlServer.Server](https://github.com/dotnet/SqlClient/tree/main/src/Microsoft.SqlServer.Server) package.[#1585](https://github.com/dotnet/SqlClient/pull/1585) |
| 27 | +- Code health improvements [#1353](https://github.com/dotnet/SqlClient/pull/1353) [#1354](https://github.com/dotnet/SqlClient/pull/1354) [#1525](https://github.com/dotnet/SqlClient/pull/1525) [#1186](https://github.com/dotnet/SqlClient/pull/1186) |
| 28 | +- Update Azure Identity dependency from 1.5.0 to 1.6.0.[#1611](https://github.com/dotnet/SqlClient/pull/1611) |
| 29 | +- Improved Regex for SqlCommandSet [#1548] (https://github.com/dotnet/SqlClient/pull/1548) |
| 30 | +- Rework on `TdsParserStateObjectManaged` with nullable annotations. [#1555] (https://github.com/dotnet/SqlClient/pull/1555) |
| 31 | + |
| 32 | +### TDS 8 Enhanced Security |
| 33 | + |
| 34 | +To use TDS 8, specify Encrypt=Strict in the connection string. Strict mode disables TrustServerCertificate (always treated as False in Strict mode). HostNameInCertificate has been added to help some Strict mode scenarios. TDS 8 begins and continues all server communication inside a secure, encrypted TLS connection. |
| 35 | + |
| 36 | +New Encrypt values have been added to clarify connection encryption behavior. Encrypt=Mandatory is equavalent to Encrypt=True and encrypts connections during the TDS connection negotiation. Encrypt=Optional is equivalent to Encrypt=False and only encrypts the connection if the server tells the client that encryption is required during the TDS connection negotiation. |
| 37 | + |
| 38 | +HostNameInCertificate can be specified in the connection string when using aliases to connect with encryption to a server that has a server certificate with a different name or alternate subject name than the name used by the client to identify the server (DNS aliases, for example). Example usage: HostNameInCertificate=MyDnsAliasName |
| 39 | + |
| 40 | +### Server SPN |
| 41 | + |
| 42 | +When connecting in an environment that has unique domain/forest topography, the ServerSPN/Server SPN and FailoverServerSPN/Failover Server SPN connection string settings can be used to override the auto-generated server SPNs used in the library when authenticating with integrated authentication in a domain environment. |
| 43 | + |
| 44 | +### Support for Aliases |
| 45 | + |
| 46 | +Users can configure Aliases by using the SQL Server Configuration Manager. These are stored in the Windows registry and are already supported when targeting .NET Framework. This release brings support for aliases when targeting .NET or .NET Core on Windows. |
| 47 | + |
| 48 | +## Target Platform Support |
| 49 | + |
| 50 | +- .NET Framework 4.6.2+ (Windows x86, Windows x64) |
| 51 | +- .NET Core 3.1+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS) |
| 52 | +- .NET Standard 2.0+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS) |
| 53 | + |
| 54 | +### Dependencies |
| 55 | + |
| 56 | +#### .NET Framework |
| 57 | + |
| 58 | +- Microsoft.Data.SqlClient.SNI.runtime 5.0.0-preview3.22165.1 |
| 59 | +- Azure.Identity 1.6.0.0 |
| 60 | +- Microsoft.Identity.Client 4.43.2.0 |
| 61 | +- Microsoft.IdentityModel.JsonWebTokens 6.8.0.0 |
| 62 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0.0 |
| 63 | +- System.Buffers 4.0.3.0 |
| 64 | +- System.Configuration 4.0.0.0 |
| 65 | +- System.Data 4.0.0.0 |
| 66 | +- System.EnterpriseServices 4.0.0.0 |
| 67 | +- System.IdentityModel.Tokens.Jwt 6.8.0.0 |
| 68 | +- System.Runtime.Caching 4.0.0.0 |
| 69 | +- System.Runtime.InteropServices.RuntimeInformation 4.0.2.0 |
| 70 | +- System.Runtime.Serialization 4.0.0.0 |
| 71 | +- System.Transactions 4.0.0.0 |
| 72 | +- System.Xml 4.0.0.0 |
| 73 | + |
| 74 | +#### .NET Core |
| 75 | + |
| 76 | +- Microsoft.Data.SqlClient.SNI.runtime 5.0.0-preview3.22165.1 |
| 77 | +- Azure.Identity 1.6.0 |
| 78 | +- Microsoft.Identity.Client 4.43.2 |
| 79 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0 |
| 80 | +- Microsoft.IdentityModel.JsonWebTokens 6.8.0 |
| 81 | +- Microsoft.SqlServer.Server 1.0.0 |
| 82 | +- Microsoft.Win32.Registry 5.0.0 |
| 83 | +- System.Buffers 4.5.1 |
| 84 | +- System.Configuration.ConfigurationManager 5.0.0 |
| 85 | +- System.Diagnostics.DiagnosticSource 5.0.0 |
| 86 | +- System.IO 4.3.0 |
| 87 | +- System.Runtime.Caching 5.0.0 |
| 88 | +- System.Text.Encoding.CodePages 5.0.0 |
| 89 | +- System.Text.Encodings.Web 4.7.2 |
| 90 | +- System.Resources.ResourceManager 4.3.0 |
| 91 | +- System.Security.Cryptography.Cng 5.0.0 |
| 92 | +- System.Security.Principal.Windows 5.0.0 |
| 93 | + |
| 94 | +#### .NET Standard |
| 95 | + |
| 96 | +- Microsoft.Data.SqlClient.SNI.runtime 5.0.0-preview3.22165.1 |
| 97 | +- Azure.Identity 1.6.0 |
| 98 | +- Microsoft.Identity.Client 4.43.2 |
| 99 | +- Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0 |
| 100 | +- Microsoft.IdentityModel.JsonWebTokens 6.8.0 |
| 101 | +- Microsoft.SqlServer.Server 1.0.0 |
| 102 | +- Microsoft.Win32.Registry 5.0.0 |
| 103 | +- System.Buffers 4.5.1 |
| 104 | +- System.Configuration.ConfigurationManager 5.0.0 |
| 105 | +- System.IO 4.3.0 |
| 106 | +- System.Runtime.Caching 5.0.0 |
| 107 | +- System.Text.Encoding.CodePages 5.0.0 |
| 108 | +- System.Text.Encodings.Web 4.7.2 |
| 109 | +- System.Resources.ResourceManager 4.3.0 |
| 110 | +- System.Runtime.Loader 4.3.0 |
| 111 | +- System.Security.Cryptography.Cng 5.0.0 |
| 112 | +- System.Security.Principal.Windows 5.0.0 |
| 113 | +- System.Security.Permissions 5.0.0 |
| 114 | +- NetStandard.Library 2.0.3 |
0 commit comments