-
Notifications
You must be signed in to change notification settings - Fork 316
5.0.0-preview1 release notes #1538
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Changes from 7 commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
85c469c
release notes
JRahnama 14fd4fd
Apply suggestions from code review
JRahnama 1bd8a37
Apply suggestions from code review
JRahnama 2705da2
Apply suggestions from code review
JRahnama df614ab
Update release-notes/5.0/5.0.0-preview1.md
JRahnama 99f5ca0
Update release-notes/5.0/5.0.0-preview1.md
JRahnama 29a40da
Merge branch 'preview1-version-5' of https://github.com/JRahnama/SqlC…
JRahnama 442aafc
Apply suggestions from code review
JRahnama db8a96c
Apply suggestions from code review
JRahnama File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,131 @@ | ||
| # Release Notes | ||
|
|
||
| ## Microsoft.Data.SqlClient 5.0.0-preview1.xxx released 9 March 2022 | ||
|
|
||
| This update brings the below changes over the previous release: | ||
|
|
||
| ### Added | ||
|
|
||
| - Added SqlDataSourceEnumerator. [#1430](https://github.com/dotnet/SqlClient/pull/1430), [Read more](#sql-data-source-enumerator-support) | ||
| - Added new attestation protocol `None` option to forgo enclave attestation when using VBS enclaves. [#1425](https://github.com/dotnet/SqlClient/pull/1425) and [#1419](https://github.com/dotnet/SqlClient/pull/1419), [Read more](#new-attestation-protocol-none) | ||
| - Added a new AppContext switch to suppress insecure TLS warnings. [#1457](https://github.com/dotnet/SqlClient/pull/1457), [Read more](#suppress-insecure-tls-warnings) | ||
|
|
||
| ### Fixed | ||
|
|
||
| - Suppressed TLS security warning with `Encrypt = false` by new AppContext switch. [#1457](https://github.com/dotnet/SqlClient/pull/1457) | ||
| - Fixed all documentation paths to Unix format path. [#1442](https://github.com/dotnet/SqlClient/pull/1442) | ||
| - Fixed thread safety issue for `GetEnclaveProvider` by converting dictionary to concurrent dictionary. [#1451](https://github.com/dotnet/SqlClient/pull/1451) | ||
|
|
||
| ### Changed | ||
| - Updated `Microsoft.Data.SqlClient.SNI` (.NET Framework dependency) and `Microsoft.Data.SqlClient.SNI.runtime` (.NET Core/Standard dependency) version to `v5.0.0-preview1.22062.1`. [#1537](https://github.com/dotnet/SqlClient/pull/1537) | ||
| - modernized style in ValueUtilSmi. [#1351](https://github.com/dotnet/SqlClient/pull/1351) | ||
| - Changed SQL server codenames to version names. [#1439](https://github.com/dotnet/SqlClient/pull/1439) | ||
| - Prevented subtype generation in project files. [#1452](https://github.com/dotnet/SqlClient/pull/1452) | ||
| - Changed `Array.Copy` to `Buffer.BlockCopy` for byte arrays. [#1366](https://github.com/dotnet/SqlClient/pull/1366) | ||
| - Changed files in csproj to be alphabetically sorted in netfx and netcore. [#1364](https://github.com/dotnet/SqlClient/pull/1364) | ||
| - TdsEnum, SqlInternalTransaction and MetaDataUtilsSmi are moved to shared folder. [#1369](https://github.com/dotnet/SqlClient/pull/1369), [#1346](https://github.com/dotnet/SqlClient/pull/1346) and [#1339](https://github.com/dotnet/SqlClient/pull/1339) | ||
JRahnama marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ### SQL Data Source Enumerator support | ||
| Provides a mechanism for enumerating all available instances of SQL Server within the local network. | ||
| ```cs | ||
| static void Main() | ||
JRahnama marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| { | ||
| // Retrieve the enumerator instance and then the data. | ||
| SqlDataSourceEnumerator instance = | ||
| SqlDataSourceEnumerator.Instance; | ||
| System.Data.DataTable table = instance.GetDataSources(); | ||
|
|
||
| // Display the contents of the table. | ||
| DisplayData(table); | ||
|
|
||
| Console.WriteLine("Press any key to continue."); | ||
| Console.ReadKey(); | ||
| } | ||
|
|
||
| private static void DisplayData(System.Data.DataTable table) | ||
| { | ||
| foreach (System.Data.DataRow row in table.Rows) | ||
| { | ||
| foreach (System.Data.DataColumn col in table.Columns) | ||
| { | ||
| Console.WriteLine("{0} = {1}", col.ColumnName, row[col]); | ||
| } | ||
| Console.WriteLine("============================"); | ||
| } | ||
| } | ||
| ``` | ||
|
|
||
| ### New Attestation protocol `None` | ||
| A new attestation protocol called "None" is allowed in the connection string, allowing users to forgo enclave attestation when using VBS enclaves: `Attestation Protocol = None` | ||
|
|
||
| - Attestation `Protocol = None` can now be added to the connection string. When this is set, the Enclave Attestation Url property is optional (it's required if Attestation Protocol is HGS or AAS). | ||
| - `Attestation Protocol = None` only works when the server returns an enclave type of VBS. An exception is thrown for any other enclave type. | ||
| - When using `Attestation Protocol = None`, the NoneAttestationEnclaveProvider will be used to set up an enclave session. This provider does not perform attestation and only derives the shared secret required to set up a secure enclave session. | ||
| - Building the driver with `-p:BuildSimulator=true` will still work, the driver will simply use NoneAttestationEnclaveProvider. When working with SQL Server in simulator mode, the attestation protocol should now be specified as None and not SIM. | ||
|
|
||
| ### Suppress insecure TLS warnings | ||
| A security warning is ouptput on the console if the TLS version less than 1.2 is used to negotiate with the server. This warning could be suppressed on SQL connection while `Encrypt = false` by enabling the following AppContext switch on the application startup: | ||
| ```cs | ||
| Switch.Microsoft.Data.SqlClient.SuppressInsecureTLSWarning | ||
| ``` | ||
|
|
||
| ## Target Platform Support | ||
|
|
||
| - .NET Framework 4.6.1+ (Windows x86, Windows x64) | ||
| - .NET Core 3.1+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS) | ||
| - .NET Standard 2.0+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS) | ||
|
|
||
| ### Dependencies | ||
|
|
||
| #### .NET Framework | ||
|
|
||
| - Microsoft.Data.SqlClient.SNI 5.0.0.preview1.22062.1 | ||
| - Azure.Identity 1.3.0 | ||
| - Microsoft.Identity.Client 4.22.0 | ||
| - Microsoft.IdentityModel.JsonWebTokens 6.8.0 | ||
| - Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0 | ||
| - System.Buffers 4.5.1 | ||
| - System.Configuration.ConfigurationManager 5.0.0 | ||
| - System.IO 4.3.0 | ||
| - System.Runtime.InteropServices.RuntimeInformation 4.3.0 | ||
| - System.Security.Cryptography.Algorithms 4.3.1 | ||
| - System.Security.Cryptography.Primitives 4.3.0 | ||
| - System.Text.Encodings.Web 4.7.2 | ||
|
|
||
| #### .NET Core | ||
|
|
||
| - Microsoft.Data.SqlClient.SNI.runtime 5.0.0.preview1.22062.1 | ||
| - Azure.Identity 1.3.0 | ||
| - Microsoft.Identity.Client 4.22.0 | ||
| - Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0 | ||
| - Microsoft.IdentityModel.JsonWebTokens 6.8.0 | ||
| - Microsoft.Win32.Registry 5.0.0 | ||
| - System.Buffers 4.5.1 | ||
| - System.Configuration.ConfigurationManager 5.0.0 | ||
| - System.Diagnostics.DiagnosticSource 5.0.0 | ||
| - System.IO 4.3.0 | ||
| - System.Runtime.Caching 5.0.0 | ||
| - System.Text.Encoding.CodePages 5.0.0 | ||
| - System.Text.Encodings.Web 4.7.2 | ||
| - System.Resources.ResourceManager 4.3.0 | ||
| - System.Security.Cryptography.Cng 5.0.0 | ||
| - System.Security.Principal.Windows 5.0.0 | ||
|
|
||
| #### .NET Standard | ||
|
|
||
| - Microsoft.Data.SqlClient.SNI.runtime 5.0.0.preview1.22062.1 | ||
| - Azure.Identity 1.3.0 | ||
| - Microsoft.Identity.Client 4.22.0 | ||
| - Microsoft.IdentityModel.Protocols.OpenIdConnect 6.8.0 | ||
| - Microsoft.IdentityModel.JsonWebTokens 6.8.0 | ||
| - Microsoft.Win32.Registry 5.0.0 | ||
| - System.Buffers 4.5.1 | ||
| - System.Configuration.ConfigurationManager 5.0.0 | ||
| - System.IO 4.3.0 | ||
| - System.Runtime.Caching 5.0.0 | ||
| - System.Text.Encoding.CodePages 5.0.0 | ||
| - System.Text.Encodings.Web 4.7.2 | ||
| - System.Resources.ResourceManager 4.3.0 | ||
| - System.Runtime.Loader 4.3.0 | ||
| - System.Security.Cryptography.Cng 5.0.0 | ||
| - System.Security.Principal.Windows 5.0.0 | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| The following Microsoft.Data.SqlClient 5.0 preview releases have been shipped: | ||
|
|
||
| | Release Date | Version | Notes | | ||
| | :-- | :-- | :--: | | ||
| | 2022/03/09 | 5.0.0-preview1.xxx | [release notes](5.0.0-preview1.md) | |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I believe we can remove 'None' attestation since it's already in 4.1