Lokasi ngalangkungan proxy:   [ UP ]  
[Ngawartoskeun bug]   [Panyetelan cookie]                
Skip to content

Commit 0ca05b9

Browse files
fenxufenxu
committed
Merging changes synced from https://github.com/MicrosoftDocs/sql-docs-pr (branch live)
2 parents 7343f09 + 4c3949f commit 0ca05b9

17 files changed

Lines changed: 1026 additions & 117 deletions

‎docs/analytics-platform-system/toc.yml‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,8 @@
66
- name: What's new in APS
77
href: ./whats-new-analytics-platform-system.md
88
items:
9+
- name: APS CU7.7
10+
href: ./whats-new-analytics-platform-system.md#h2-aps-cu7.7
911
- name: APS CU7.6
1012
href: ./whats-new-analytics-platform-system.md#h2-aps-cu7.6
1113
- name: APS CU7.5

‎docs/analytics-platform-system/whats-new-analytics-platform-system.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,16 @@ ms.custom: seo-dt-2019
1414
See what's new in the latest Appliance Updates for Microsoft Analytics Platform System (APS). APS is a scale-out on-premises appliance that hosts MPP SQL Server Parallel Data Warehouse.
1515

1616
::: moniker range=">= aps-pdw-2016-au7 || = sqlallproducts-allversions"
17+
<a name="h2-aps-cu7.7"></a>
18+
## APS CU7.7
19+
Release date - November 2020
20+
21+
### SCVMM2016
22+
APS CU7.7 software upgrades VMM VM to Windows Server 2016 and installs SCVMM2016. SCVMM 2012 R2 that is currently in use has an end of life date of July 2022. The newer SCVMM is needed to be supported making CU7.7 a mandatory upgrade. Customers are urged to upgrade to CU7.7 as soon as possible.
23+
24+
### SSIS destination adapter for SQL Server 2019 as target
25+
New APS SSIS destination adapter that supports SQL Server 2019 as deployment target can be downloaded from [download site](https://www.microsoft.com/download/details.aspx?id=57472).
26+
1727
<a name="h2-aps-cu7.6"></a>
1828
## APS CU7.6
1929
Release date - April 2020

‎docs/connect/ado-net/download-microsoft-sqlclient-data-provider.md‎

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: "Download Microsoft SqlClient Data Provider for SQL Server"
33
description: "Download page for ADO.NET and Microsoft SqlClient Data Provider for SQL Server."
4-
ms.date: "06/16/2020"
5-
dev_langs:
4+
ms.date: "11/19/2020"
5+
dev_langs:
66
- "csharp"
77
- "vb"
88
ms.assetid: 6f5ff56a-a57e-49d7-8ae9-bbed697e42e3
@@ -12,19 +12,21 @@ ms.technology: connectivity
1212
ms.topic: conceptual
1313
author: David-Engel
1414
ms.author: v-daenge
15-
ms.reviewer: v-kaywon
15+
ms.reviewer: v-jizho2
1616
---
1717
# Download Microsoft SqlClient Data Provider for SQL Server
1818

1919
## Downloading the driver
2020
The Microsoft.Data.SqlClient package is available on NuGet.org. Refer to the dependencies section from the links below to download the dependencies.
2121

2222
## Download stable versions of Microsoft SqlClient Data Provider for SQL Server
23+
* [2.1.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/2.1.0)
24+
* [2.0.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/2.0.1)
2325
* [2.0.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/2.0.0)
2426
* [1.1.3](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.1.3)
2527
* [1.1.2](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.1.2)
2628
* [1.1.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.1.1)
2729
* [1.1.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.1.0)
2830
* [1.0.19269.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.0.19269.1)
2931
* [1.0.19249.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.0.19249.1)
30-
* [1.0.19239.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.0.19239.1)
32+
* [1.0.19239.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/1.0.19239.1)

‎docs/connect/ado-net/introduction-microsoft-data-sqlclient-namespace.md‎

Lines changed: 221 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,235 @@
11
---
22
title: "Introduction to Microsoft.Data.SqlClient namespace"
33
description: "Learn about the Microsoft.Data.SqlClient namespace and how it's the preferred way to connect to SQL for .NET applications."
4-
ms.date: "09/29/2020"
4+
ms.date: "11/19/2020"
55
ms.assetid: c18b1fb1-2af1-4de7-80a4-95e56fd976cb
66
ms.prod: sql
77
ms.prod_service: connectivity
88
ms.technology: connectivity
99
ms.topic: conceptual
1010
author: David-Engel
1111
ms.author: v-daenge
12-
ms.reviewer: v-kaywon
12+
ms.reviewer: v-jizho2
1313
---
1414
# Introduction to Microsoft.Data.SqlClient namespace
1515

1616
[!INCLUDE [Driver_ADONET_Download](../../includes/driver_adonet_download.md)]
1717

18+
## Release notes for Microsoft.Data.SqlClient 2.1
19+
20+
Release notes are also available in the GitHub Repository: [2.1 Release Notes](https://github.com/dotnet/SqlClient/tree/master/release-notes/2.1).
21+
22+
### New features
23+
24+
### Cross-Platform support for Always Encrypted
25+
Microsoft.Data.SqlClient v2.1 extends support for Always Encrypted on the following platforms:
26+
27+
| Support Always Encrypted | Support Always Encrypted with Secure Enclave | Target Framework | Microsoft.Data.SqlClient Version | Operating System |
28+
|:--|:--|:--|:--:|:--:|
29+
| Yes | Yes | .NET Framework 4.6+ | 1.1.0+ | Windows |
30+
| Yes | Yes | .NET Core 2.1+ | 2.1.0+<sup>1</sup> | Windows, Linux, macOS |
31+
| Yes | No<sup>2</sup> | .NET Standard 2.0 | 2.1.0+ | Windows, Linux, macOS |
32+
| Yes | Yes | .NET Standard 2.1+ | 2.1.0+ | Windows, Linux, macOS |
33+
34+
> [!NOTE]
35+
> <sup>1</sup> Before Microsoft.Data.SqlClient version v2.1, Always Encrypted is only supported on Windows.
36+
> <sup>2</sup> Always Encrypted with secure enclaves is not supported on .NET Standard 2.0.
37+
38+
### Azure Active Directory Device Code Flow authentication
39+
Microsoft.Data.SqlClient v2.1 provides support for "Device Code Flow" authentication with MSAL.NET.
40+
Reference documentation: [OAuth2.0 Device Authorization Grant flow](https://docs.microsoft.com/azure/active-directory/develop/v2-oauth2-device-code)
41+
42+
Connection string example:
43+
44+
`Server=<server>.database.windows.net; Authentication=Active Directory Device Code Flow; Database=Northwind;`
45+
46+
The following API enables customization of the Device Code Flow callback mechanism:
47+
48+
```csharp
49+
public class ActiveDirectoryAuthenticationProvider
50+
{
51+
// For .NET Framework, .NET Core and .NET Standard targeted applications
52+
public void SetDeviceCodeFlowCallback(Func<DeviceCodeResult, Task> deviceCodeFlowCallbackMethod)
53+
}
54+
```
55+
56+
### Azure Active Directory Managed Identity authentication
57+
Microsoft.Data.SqlClient v2.1 introduces support for Azure Active Directory authentication using [managed identities](https://docs.microsoft.com/azure/active-directory/managed-identities-azure-resources/overview).
58+
59+
The following authentication mode keywords are supported:
60+
- Active Directory Managed Identity
61+
- Active Directory MSI (for cross MS SQL drivers compatibility)
62+
63+
Connection string examples:
64+
65+
```cs
66+
// For System Assigned Managed Identity
67+
"Server={serverURL}; Authentication=Active Directory MSI; Initial Catalog={db};"
68+
69+
// For System Assigned Managed Identity
70+
"Server={serverURL}; Authentication=Active Directory Managed Identity; Initial Catalog={db};"
71+
72+
// For User Assigned Managed Identity
73+
"Server={serverURL}; Authentication=Active Directory MSI; User Id={ObjectIdOfManagedIdentity}; Initial Catalog={db};"
74+
75+
// For User Assigned Managed Identity
76+
"Server={serverURL}; Authentication=Active Directory Managed Identity; User Id={ObjectIdOfManagedIdentity}; Initial Catalog={db};"
77+
```
78+
79+
### Azure Active Directory Interactive authentication enhancements
80+
Microsoft.Data.SqlClient v2.1 adds the following APIs to customize the "Active Directory Interactive" authentication experience:
81+
82+
```csharp
83+
public class ActiveDirectoryAuthenticationProvider
84+
{
85+
// For .NET Framework targeted applications only
86+
public void SetIWin32WindowFunc(Func<IWin32Window> iWin32WindowFunc);
87+
88+
// For .NET Standard targeted applications only
89+
public void SetParentActivityOrWindowFunc(Func<object> parentActivityOrWindowFunc);
90+
91+
// For .NET Framework, .NET Core and .NET Standard targeted applications
92+
public void SetAcquireAuthorizationCodeAsyncCallback(Func<Uri, Uri, CancellationToken, Task<Uri>> acquireAuthorizationCodeAsyncCallback);
93+
94+
// For .NET Framework, .NET Core and .NET Standard targeted applications
95+
public void ClearUserTokenCache();
96+
}
97+
```
98+
99+
### `SqlClientAuthenticationProviders` configuration section
100+
Microsoft.Data.SqlClient v2.1 introduces a new configuration section, `SqlClientAuthenticationProviders` (a clone of the existing `SqlAuthenticationProviders`). The existing configuration section, `SqlAuthenticationProviders`, is still supported for backwards compatibility when the appropriate type is defined.
101+
102+
The new section allows application config files to contain both a SqlAuthenticationProviders section for System.Data.SqlClient and a SqlClientAuthenticationProviders section for Microsoft.Data.SqlClient.
103+
104+
105+
### Azure Active Directory authentication using an application client ID
106+
Microsoft.Data.SqlClient v2.1 introduces support for passing a user-defined application client ID to the Microsoft Authentication Library. Application Client ID is used when authenticating with Azure Active Directory.
107+
108+
The following new APIs are introduced:
109+
110+
1. A new constructor has been introduced in ActiveDirectoryAuthenticationProvider:\
111+
_[Applies to all .NET Platforms (.NET Framework, .NET Core, and .NET Standard)]_
112+
113+
```csharp
114+
public ActiveDirectoryAuthenticationProvider(string applicationClientId)
115+
```
116+
117+
Usage:
118+
```csharp
119+
string APP_CLIENT_ID = "<GUID>";
120+
SqlAuthenticationProvider customAuthProvider = new ActiveDirectoryAuthenticationProvider(APP_CLIENT_ID);
121+
SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryInteractive, customAuthProvider);
122+
123+
using (SqlConnection sqlConnection = new SqlConnection("<connection_string>")
124+
{
125+
sqlConnection.Open();
126+
}
127+
```
128+
129+
2. A new configuration property has been introduced under `SqlAuthenticationProviderConfigurationSection` and `SqlClientAuthenticationProviderConfigurationSection`:\
130+
_[Applies to .NET Framework and .NET Core]_
131+
132+
```csharp
133+
internal class SqlAuthenticationProviderConfigurationSection : ConfigurationSection
134+
{
135+
...
136+
[ConfigurationProperty("applicationClientId", IsRequired = false)]
137+
public string ApplicationClientId => this["applicationClientId"] as string;
138+
}
139+
140+
// Inheritance
141+
internal class SqlClientAuthenticationProviderConfigurationSection : SqlAuthenticationProviderConfigurationSection
142+
{ ... }
143+
```
144+
145+
Usage:
146+
```xml
147+
<configuration>
148+
<configSections>
149+
<section name="SqlClientAuthenticationProviders"
150+
type="Microsoft.Data.SqlClient.SqlClientAuthenticationProviderConfigurationSection, Microsoft.Data.SqlClient" />
151+
</configSections>
152+
<SqlClientAuthenticationProviders applicationClientId ="<GUID>" />
153+
</configuration>
154+
155+
<!--or-->
156+
157+
<configuration>
158+
<configSections>
159+
<section name="SqlAuthenticationProviders"
160+
type="Microsoft.Data.SqlClient.SqlAuthenticationProviderConfigurationSection, Microsoft.Data.SqlClient" />
161+
</configSections>
162+
<SqlAuthenticationProviders applicationClientId ="<GUID>" />
163+
</configuration>
164+
```
165+
166+
### Data Classification v2 support
167+
Microsoft.Data.SqlClient v2.1 introduces support for Data Classification's "Sensitivity Rank" information. The following new APIs are now available:
168+
169+
```csharp
170+
public class SensitivityClassification
171+
{
172+
public SensitivityRank SensitivityRank;
173+
}
174+
175+
public class SensitivityProperty
176+
{
177+
public SensitivityRank SensitivityRank;
178+
}
179+
180+
public enum SensitivityRank
181+
{
182+
NOT_DEFINED = -1,
183+
NONE = 0,
184+
LOW = 10,
185+
MEDIUM = 20,
186+
HIGH = 30,
187+
CRITICAL = 40
188+
}
189+
```
190+
191+
### Server Process ID for an active `SqlConnection`
192+
Microsoft.Data.SqlClient v2.1 introduces a new `SqlConnection` property, `ServerProcessId`, on an active connection.
193+
194+
```csharp
195+
public class SqlConnection
196+
{
197+
// Returns the server process Id (SPID) of the active connection.
198+
public int ServerProcessId;
199+
}
200+
```
201+
202+
### Trace Logging support in Native SNI
203+
Microsoft.Data.SqlClient v2.1 extends the existing `SqlClientEventSource` implementation to enable event tracing in SNI.dll. Events must be captured using a tool like Xperf.
204+
205+
Tracing can be enabled by sending a command to `SqlClientEventSource` as illustrated below:
206+
207+
```csharp
208+
// Enables trace events:
209+
EventSource.SendCommand(eventSource, (EventCommand)8192, null);
210+
211+
// Enables flow events:
212+
EventSource.SendCommand(eventSource, (EventCommand)16384, null);
213+
214+
// Enables both trace and flow events:
215+
EventSource.SendCommand(eventSource, (EventCommand)(8192 | 16384), null);
216+
```
217+
218+
219+
### "Command Timeout" connection string property
220+
Microsoft.Data.SqlClient v2.1 introduces the "Command Timeout" connection string property to override the default of 30 seconds. The timeout for individual commands can be overridden using the `CommandTimeout` property on the SqlCommand.
221+
222+
Connection string examples:
223+
224+
`"Server={serverURL}; Initial Catalog={db}; Integrated Security=true; Command Timeout=60"`
225+
226+
### Removal of symbols from Native SNI
227+
With Microsoft.Data.SqlClient v2.1, we've removed the symbols introduced in [v2.0.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI/2.0.0) from [Microsoft.Data.SqlClient.SNI.runtime](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI.runtime) NuGet starting with [v2.1.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient.SNI.runtime/2.1.1). The public symbols are now published to Microsoft Symbols Server for tools like BinSkim that require access to public symbols.
228+
229+
### Source-Linking of Microsoft.Data.SqlClient symbols
230+
Starting with Microsoft.Data.SqlClient v2.1, Microsoft.Data.SqlClient symbols are source-linked and published to the Microsoft Symbols Server for an enhanced debugging experience without the need to download source code.
231+
232+
18233
## Release notes for Microsoft.Data.SqlClient 2.0
19234

20235
Release notes are also available in the GitHub Repository: [2.0 Release Notes](https://github.com/dotnet/SqlClient/tree/master/release-notes/2.0).
@@ -39,7 +254,7 @@ Release notes are also available in the GitHub Repository: [2.0 Release Notes](h
39254

40255
#### DNS failure resiliency
41256

42-
The driver will now cache IP addresses from every successful connection to a SQL Server endpoint that supports the feature. If a DNS resolution failure occurs during a connection attempt, the driver will try establishing a connection using a cached IP address for that server, if any exists.
257+
The driver will now cache IP addresses from every successful connection to a SQL Server endpoint that supports the feature. If a DNS resolution failure occurs during a connection attempt, the driver will try establishing a connection using a cached IP address for that server, if any exists.
43258

44259
#### EventSource tracing
45260

@@ -61,7 +276,7 @@ AppContext.SetSwitch("Switch.Microsoft.Data.SqlClient.UseManagedNetworkingOnWind
61276

62277
See [AppContext Switches in SqlClient](appcontext-switches.md) for a full list of available switches in the driver.
63278

64-
#### Enabling decimal truncation behavior
279+
#### Enabling decimal truncation behavior
65280

66281
The decimal data scale will be rounded by the driver by default as is done by SQL Server. For backwards compatibility, you can set the AppContext switch **"Switch.Microsoft.Data.SqlClient.TruncateScaledDecimal"** to **true**.
67282

@@ -86,7 +301,7 @@ New synonyms have been added for the following existing connection string proper
86301

87302
#### SqlBulkCopy RowsCopied property
88303

89-
The RowsCopied property provides read-only access to the number of rows that have been processed in the ongoing bulk copy operation. This value may not necessarily be equal to the final number of rows added to the destination table.
304+
The RowsCopied property provides read-only access to the number of rows that have been processed in the ongoing bulk copy operation. This value may not necessarily be equal to the final number of rows added to the destination table.
90305

91306
#### Connection open overrides
92307

@@ -216,4 +431,4 @@ Different authentication modes can be specified by using the _Authentication_ co
216431

217432
> [!NOTE]
218433
> Custom key store providers, like the Azure Key Vault provider, will need to be updated to support Microsoft.Data.SqlClient. Similarly, enclave providers will also need to be updated to support Microsoft.Data.SqlClient.
219-
> Always Encrypted is only supported against .NET Framework and .NET Core targets. It is not supported against .NET Standard since .NET Standard is missing certain encryption dependencies.
434+
> Always Encrypted is only supported against .NET Framework and .NET Core targets. It is not supported against .NET Standard since .NET Standard is missing certain encryption dependencies.

‎docs/connect/ado-net/microsoft-ado-net-sql-server.md‎

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -16,28 +16,28 @@ ms.reviewer: v-kaywon
1616

1717
[!INCLUDE[Driver_ADONET_Download](../../includes/driver_adonet_download.md)]
1818

19-
ADO.NET is the core data access technology for .NET languages. Use the Microsoft.Data.SqlClient namespace to access SQL Server, or providers from other suppliers to access their stores. Use System.Data.Odbc or System.Data.Oledb to access data from .NET languages using other data access technologies. Use System.Data.Dataset when you need an offline data cache in client applications. It also provides local persistence and XML capabilities that can be useful in web services.
20-
21-
## Getting started
22-
* [Step 1: Configure development environment for ADO.NET development](step-1-configure-development-environment-ado-net-development.md)
23-
* [Step 2: Create a SQL database for ADO.NET development](step-2-create-sql-database-ado-net-development.md)
24-
* [Step 3: Proof of concept connecting to SQL using ADO.NET](step-3-connect-sql-ado-net.md)
25-
* [Step 4: Connect resiliently to SQL with ADO.NET](step-4-connect-resiliently-sql-ado-net.md)
26-
27-
## Documentation
19+
ADO.NET is the core data access technology for .NET languages. Use the Microsoft.Data.SqlClient namespace to access SQL Server, or providers from other suppliers to access their stores. Use System.Data.Odbc or System.Data.Oledb to access data from .NET languages using other data access technologies. Use System.Data.Dataset when you need an offline data cache in client applications. It also provides local persistence and XML capabilities that can be useful in web services.
20+
21+
## Getting started
22+
* [Step 1: Configure development environment for ADO.NET development](step-1-configure-development-environment-ado-net-development.md)
23+
* [Step 2: Create a SQL database for ADO.NET development](step-2-create-sql-database-ado-net-development.md)
24+
* [Step 3: Proof of concept connecting to SQL using ADO.NET](step-3-connect-sql-ado-net.md)
25+
* [Step 4: Connect resiliently to SQL with ADO.NET](step-4-connect-resiliently-sql-ado-net.md)
26+
27+
## Documentation
2828
* [ADO.NET Overview](/dotnet/framework/data/adonet/)
29-
* [Getting started with the SqlClient driver](get-started-sqlclient-driver.md)
30-
* [Overview of the SqlClient driver](overview-sqlclient-driver.md)
29+
* [Getting started with the SqlClient driver](get-started-sqlclient-driver.md)
30+
* [Overview of the SqlClient driver](overview-sqlclient-driver.md)
3131
* [SQL Server and ADO.NET](./sql/index.md)
32-
33-
## Community
34-
* [ADO.NET Managed Providers Forum](https://social.msdn.microsoft.com/Forums/en-US/home?forum=adodotnetdataproviders)
35-
* [ADO.NET DataSet Forum](https://social.msdn.microsoft.com/Forums/en-US/home?forum=adodotnetdataset)
36-
37-
## More samples
38-
* [ADO.NET Code Examples](/dotnet/framework/data/adonet/ado-net-code-examples)
32+
33+
## Community
34+
* [ADO.NET Managed Providers Forum](https://social.msdn.microsoft.com/Forums/home?forum=adodotnetdataproviders)
35+
* [ADO.NET DataSet Forum](https://social.msdn.microsoft.com/Forums/home?forum=adodotnetdataset)
36+
37+
## More samples
38+
* [ADO.NET Code Examples](/dotnet/framework/data/adonet/ado-net-code-examples)
3939
* [Getting Started with .NET Framework on Windows](https://www.microsoft.com/sql-server/developer-get-started/csharp/win/)
4040
* [Getting Started with .NET Core on macOS](https://www.microsoft.com/sql-server/developer-get-started/csharp/macos/)
4141
* [Getting Started with .NET Core on Ubuntu](https://www.microsoft.com/sql-server/developer-get-started/csharp/ubuntu/)
4242
* [Getting Started with .NET Core on Red Hat Enterprise Linux (RHEL)](https://www.microsoft.com/sql-server/developer-get-started/csharp/rhel/)
43-
43+

0 commit comments

Comments
 (0)