Skip to content

Commit ebbecab

Browse files
cheenamalhotracheenamalhotra
authored
GA 2.0 release notes (dotnet#605)
1 parent d10e1d6 commit ebbecab

File tree

7 files changed

+260
-11
lines changed

7 files changed

+260
-11
lines changed

‎BUILDGUIDE.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This document provides all the necessary details to build the driver and run tes
44

55
## Visual Studio Pre-Requisites
66

7-
This project should be ideally built with Visual Studio 2017+ for the best compatibility. Use either of the two environments with their required set of compoenents as mentioned below:
7+
This project should be built with Visual Studio 2019+ for the best compatibility. The required set of components are provided in the below file:
88
- **Visual Studio 2019** with imported components: [VS19Components](/tools/vsconfig/VS19Components.vsconfig)
99

1010
Once the environment is setup properly, execute the desired set of commands below from the _root_ folder to perform the respective operations:
@@ -106,6 +106,7 @@ Manual Tests require the below setup to run:
106106
|------|--------|-------------------|
107107
|TCPConnectionString | Connection String for a TCP enabled SQL Server instance. | `Server={servername};Database={Database_Name};Trusted_Connection=True;` <br/> OR `Data Source={servername};Initial Catalog={Database_Name};Integrated Security=True;`|
108108
|NPConnectionString | Connection String for a Named Pipes enabled SQL Server instance.| `Server=\\{servername}\pipe\sql\query;Database={Database_Name};Trusted_Connection=True;` <br/> OR <br/> `Data Source=np:{servername};Initial Catalog={Database_Name};Integrated Security=True;`|
109+
|TCPConnectionStringHGSVBS | (Optional) Connection String for a TCP enabled SQL Server with Host Guardian Service (HGS) attestation protocol configuration. | `Server=tcp:{servername}; Database={Database_Name}; UID={UID}; PWD={PWD}; Attestation Protocol = HGS; Enclave Attestation Url = {AttestationURL};`|
109110
|AADAuthorityURL | (Optional) Identifies the OAuth2 authority resource for `Server` specified in `AADPasswordConnectionString` | `https://login.windows.net/<tenant>`, where `<tenant>` is the tenant ID of the Azure Active Directory (Azure AD) tenant |
110111
|AADPasswordConnectionString | (Optional) Connection String for testing Azure Active Directory Password Authentication. | `Data Source={server.database.windows.net}; Initial Catalog={Azure_DB_Name};Authentication=Active Directory Password; User ID={AAD_User}; Password={AAD_User_Password};`|
111112
|AADSecurePrincipalId | (Optional) The Application Id of a registered application which has been granted permission to the database defined in the AADPasswordConnectionString. | {Application ID} |
@@ -204,9 +205,9 @@ Tests can be built and run with custom Target Frameworks. See the below examples
204205
```
205206

206207
```bash
207-
> msbuild /t:BuildTestsNetCore /p:TargetNetCoreVersion=netcoreapp3.0
208+
> msbuild /t:BuildTestsNetCore /p:TargetNetCoreVersion=netcoreapp3.1
208209
# Build the tests for custom TargetFramework (.NET Core)
209-
# Applicable values: netcoreapp2.1 | netcoreapp2.2 | netcoreapp3.0
210+
# Applicable values: netcoreapp2.1 | netcoreapp2.2 | netcoreapp3.1 | netcoreapp5.0
210211
```
211212

212213
### Running Tests:
@@ -216,9 +217,9 @@ Tests can be built and run with custom Target Frameworks. See the below examples
216217
# Use above property to run Functional Tests with custom TargetFramework (.NET Framework)
217218
# Applicable values: net46 (Default) | net461 | net462 | net47 | net471 net472 | net48
218219

219-
> dotnet test /p:TargetNetCoreVersion=netcoreapp3.0 ...
220+
> dotnet test /p:TargetNetCoreVersion=netcoreapp3.1 ...
220221
# Use above property to run Functional Tests with custom TargetFramework (.NET Core)
221-
# Applicable values: netcoreapp2.1 | netcoreapp2.2 | netcoreapp3.0
222+
# Applicable values: netcoreapp2.1 | netcoreapp2.2 | netcoreapp3.1 | netcoreapp5.0
222223
```
223224

224225
## Using Managed SNI on Windows
@@ -256,7 +257,7 @@ There may be times where connection cannot be made to SQL Server, we found below
256257
257258
- Clear Docker images to create clean image from time-to-time, and clear docker cache if needed by running `docker system prune` in Command Prompt.
258259
259-
- If you face `sni.dll not found` errors when debugging, try updating below properties in netcore\Microsoft.Data.SqlClient.csproj file and try again:
260+
- If you face `Microsoft.Data.SqlClient.SNI.dll not found` errors when debugging, try updating the below properties in the netcore\Microsoft.Data.SqlClient.csproj file and try again:
260261
```xml
261262
<OSGroup>Unix</OSGroup>
262263
<TargetsWindows>false</TargetsWindows>

‎CHANGELOG.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,31 @@ All notable changes to this project will be documented in this file.
44

55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
66

7-
## [Preview Release 2.0.0-preview4.20142.4 ] - 2020-05-21
7+
## [Stable Release 2.0.0] - 2020-06-16
8+
9+
### Added
10+
- Added internal driver support to provide resiliency to DNS failures [#594](https://github.com/dotnet/SqlClient/pull/594)
11+
- Added support for `Active Directory Integrated`, `Active Directory Interactive` and `Active Directory Service Principal` authentication mode for .NET Core and .NET Standard [#560](https://github.com/dotnet/SqlClient/pull/560)
12+
- Added support for `Active Directory Service Principal` authentication mode for .NET Framework [#560](https://github.com/dotnet/SqlClient/pull/560)
13+
- Added support for optional `ORDER` hints in `SqlBulkCopy` for improved performance [#540](https://github.com/dotnet/SqlClient/pull/540)
14+
15+
### Fixed
16+
- Fixed `SqlSequentialStream` multipacket read stalling issue in .NET Core [#603](https://github.com/dotnet/SqlClient/pull/603)
17+
- Fixed code page issue for Kazakh collation in SQL Server [#584](https://github.com/dotnet/SqlClient/pull/584)
18+
- Fixed stalled application issues when end of stream is reached [#577](https://github.com/dotnet/SqlClient/pull/577)
19+
- Fixed driver behavior to not throw exception for invalid configuration file [#573](https://github.com/dotnet/SqlClient/pull/573)
20+
- Fixed Object null reference issue when failover partner is set [#588](https://github.com/dotnet/SqlClient/pull/588)
21+
- Fixed `applicationintent` connection string property issue [#585](https://github.com/dotnet/SqlClient/pull/585)
22+
23+
### Changes
24+
- Raise warning message when insecure TLS protocols are in use [#591](https://github.com/dotnet/SqlClient/pull/591)
25+
26+
### Breaking Changes
27+
- Modified enclave provider interface `SqlColumnEncryptionEnclaveProvider` to be internal [#602](https://github.com/dotnet/SqlClient/pull/602) - _This change is not likely to impact customer applications since secure enclaves is a relatively new feature and they would have had to implement their own enclave provider, which is not a trivial task_.
28+
- Updated `SqlClientMetaDataCollectionNames` exposed constants by removing non-existing constants and adding new to the metadata collection [#580](https://github.com/dotnet/SqlClient/pull/580)
29+
30+
31+
## [Preview Release 2.0.0-preview4.20142.4] - 2020-05-21
832

933
### Added
1034
- Microsoft.Data.SqlClient (.NET Core and .NET Standard) on Windows is now dependent on **Microsoft.Data.SqlClient.SNI.runtime**, replacing the previous dependency on **runtime.native.System.Data.SqlClient.SNI** [#570](https://github.com/dotnet/SqlClient/pull/570)

‎README.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ The Microsoft.Data.SqlClient NuGet package is available on [NuGet.org](https://w
2424

2525
## SNI Package References
2626

27-
For the .NET Framework driver on Windows, a package reference to [Microsoft.Data.SqlClient.SNI](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI/) loads `x64` and `x86` native `SNI.dll` libraries into the client's build directories.
27+
For the .NET Framework driver on Windows, a package reference to [Microsoft.Data.SqlClient.SNI](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI/) loads native `Microsoft.Data.SqlClient.SNI.x64.dll` and `Microsoft.Data.SqlClient.SNI.x86.dll` libraries into the client's build directories.
2828

29-
For the .NET Core driver on Windows, a package reference to [runtime.native.System.Data.SqlClient.sni](https://www.nuget.org/packages/runtime.native.System.Data.SqlClient.sni/) loads `arm64`, `x64` and `x86` native `SNI.dll` libraries into the client's build directories.
29+
For the .NET Core driver on Windows, a package reference to [Microsoft.Data.SqlClient.SNI.runtime](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI.runtime/) loads `arm`, `arm64`, `x64` and `x86` native `Microsoft.Data.SqlClient.SNI.dll` libraries into the client's build directories.
3030

3131
## Helpful Links
3232

@@ -48,9 +48,10 @@ We thank you for your continuous support in improving the SqlClient library!
4848

4949
- Wraith ([@Wraith2](https://github.com/Wraith2))
5050
- Erik Ejlskov Jensen ([@ErikEJ](https://github.com/ErikEJ))
51+
- Simon Cropp ([@SimonCropp](https://github.com/SimonCropp))
5152
- Stefán Jökull Sigurðarson ([@stebet](https://github.com/stebet))
52-
- Stephen Toub ([@stephentoub](https://github.com/stephentoub))
5353
- Shay Rojansky ([@roji](https://github.com/roji))
54+
- Stephen Toub ([@stephentoub](https://github.com/stephentoub))
5455
- Rasmus Melchior Jacobsen ([@rmja](https://github.com/rmja))
5556
- Phillip Haydon ([@phillip-haydon](https://github.com/phillip-haydon))
5657
- Robin Sue ([@Suchiman](https://github.com/Suchiman))

0 commit comments

Comments
 (0)