Skip to content

Commit fa48ca2

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/sql-docs-pr (branch live)
2 parents 8cb630f + c223fd8 commit fa48ca2

9 files changed

Lines changed: 75 additions & 45 deletions

azure-sql/database/elastic-jobs-overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,7 @@ These are the current limitations to the Elastic Jobs service. We're actively w
8484
| Excessive Audit logs from Jobs database | The Elastic Job agent operates by constantly polling the Job database to check for the arrival of new jobs and other CRUD operations. If auditing is enabled on the server that houses a Jobs database, a large amount of audit logs may be generated by the Jobs database. This can be mitigated by filtering out these audit logs using the `Set-AzSqlServerAudit` command with a predicate expression.<BR/><BR/>For example:<BR/> `Set-AzSqlServerAudit -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -BlobStorageTargetState Enabled -StorageAccountResourceId "/subscriptions/7fe3301d-31d3-4668-af5e-211a890ba6e3/resourceGroups/resourcegroup01/providers/Microsoft.Storage/storageAccounts/mystorage" -PredicateExpression "database_principal_name <> '##MS_JobAccount##'"`<BR/><BR/>This command will only filter out Job Agent to Jobs database audit logs, not Job Agent to any target databases audit logs.|
8585
| Private endpoints are not supported | Elastic Job Agents currently cannot connect to Databases and Elastic Pools which restrict connections to private endpoints.|
8686
| Use of a Hyperscale database as *Job database* | Using a Hyperscale database as a *Job database* isn't supported. However, elastic jobs can target Hyperscale databases in the same way as any other database in Azure SQL Database.|
87+
| Serverless DBs and auto-pausing with Elastic Jobs. | When the job database is a serverless database, databases targeted by elastic jobs support auto-pausing, but will be resumed by job connections.
8788

8889
## Best practices for creating jobs
8990

azure-sql/database/job-automation-overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ Consider the following job scheduling technologies on different platforms:
4646
- **Elastic Jobs** are Job Scheduling services that execute custom jobs on one or many databases in Azure SQL Database.
4747
- **SQL Agent Jobs** are executed by the SQL Agent service that continues to be used for task automation in SQL Server and is also included with Azure SQL Managed Instances. SQL Agent Jobs are not available in Azure SQL Database.
4848

49-
Elastic Jobs can target [Azure SQL Databases](sql-database-paas-overview.md), [Azure SQL Database elastic pools](elastic-pool-overview.md), and Azure SQL Databases in [shard maps](elastic-scale-shard-map-management.md).
49+
Elastic Jobs can target [Azure SQL Databases](sql-database-paas-overview.md), [Azure SQL Database elastic pools](elastic-pool-overview.md).
5050

5151
- For T-SQL script job automation in SQL Server and Azure SQL Managed Instance, consider [SQL Agent](../managed-instance/job-automation-managed-instance.md).
5252

@@ -56,7 +56,7 @@ It is worth noting differences between SQL Agent (available in SQL Server and as
5656

5757
| |Elastic Jobs |SQL Agent |
5858
|---------|---------|---------|
59-
|**Scope** | Any number of databases in Azure SQL Database and/or data warehouses in the same Azure cloud as the job agent. Targets can be in different servers, subscriptions, and/or regions. <br><br>Target groups can be composed of individual databases or data warehouses, or all databases in a server, pool, or shard map (dynamically enumerated at job runtime). | Any individual database in the same instance as the SQL agent. The Multi Server Administration feature of SQL Server Agent allows for master/target instances to coordinate job execution, though this feature is not available in SQL managed instance. |
59+
|**Scope** | Any number of databases in Azure SQL Database and/or data warehouses in the same Azure cloud as the job agent. Targets can be in different servers, subscriptions, and/or regions (dynamically enumerated at job runtime). | Any individual database in the same instance as the SQL agent. The Multi Server Administration feature of SQL Server Agent allows for master/target instances to coordinate job execution, though this feature is not available in SQL managed instance. |
6060
|**Supported APIs and Tools** | Portal, PowerShell, T-SQL, Azure Resource Manager | T-SQL, SQL Server Management Studio (SSMS) |
6161

6262
## Elastic job targets

azure-sql/database/outbound-firewall-rule-overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Outbound firewall rules limit network traffic from the Azure SQL [logical server
2222
- [OPENROWSET](/sql/t-sql/functions/openrowset-transact-sql)
2323
- [Bulk Insert](/sql/t-sql/statements/bulk-insert-transact-sql)
2424
- [Elastic query](elastic-query-overview.md)
25+
- [sp_invoke_external_rest_endpoint](https://learn.microsoft.com/sql/relational-databases/system-stored-procedures/sp-invoke-external-rest-endpoint-transact-sql)
2526

2627
> [!IMPORTANT]
2728
> - This article applies to both Azure SQL Database and [dedicated SQL pool (formerly SQL DW)](/azure/synapse-analytics/sql-data-warehouse/sql-data-warehouse-overview-what-is) in Azure Synapse Analytics. These settings apply to all SQL Database and dedicated SQL pool (formerly SQL DW) databases associated with the server. For simplicity, the term 'database' refers to both databases in Azure SQL Database and Azure Synapse Analytics. Likewise, any references to 'server' is referring to the [logical SQL server](logical-servers.md) that hosts Azure SQL Database and dedicated SQL pool (formerly SQL DW) in Azure Synapse Analytics. This article does *not* apply to Azure SQL Managed Instance or dedicated SQL pools in Azure Synapse Analytics workspaces.

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Download Microsoft SqlClient Data Provider for SQL Server
33
description: Download page for ADO.NET and Microsoft SqlClient Data Provider for SQL Server.
44
author: David-Engel
55
ms.author: v-davidengel
6-
ms.date: 07/26/2022
6+
ms.date: 01/11/2023
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: conceptual
@@ -20,6 +20,7 @@ If you need to download the Microsoft.Data.SqlClient package for offline use, it
2020

2121
## Download stable versions of Microsoft SqlClient Data Provider for SQL Server
2222

23+
* [5.1.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/5.1.0)
2324
* [5.0.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/5.0.0)
2425
* [4.1.0](https://www.nuget.org/packages/Microsoft.Data.SqlClient/4.1.0)
2526
* [4.0.1](https://www.nuget.org/packages/Microsoft.Data.SqlClient/4.0.1)

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

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ 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.
44
author: David-Engel
55
ms.author: v-davidengel
6-
ms.date: 07/26/2022
6+
ms.date: 01/11/2022
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: conceptual
@@ -14,12 +14,39 @@ ms.topic: conceptual
1414

1515
The Microsoft.Data.SqlClient namespace is essentially a new version of the System.Data.SqlClient namespace. Microsoft.Data.SqlClient generally maintains the same API and backwards compatibility with System.Data.SqlClient. To migrate from System.Data.SqlClient to Microsoft.Data.SqlClient, for most applications, it's simple. Add a NuGet dependency on Microsoft.Data.SqlClient and update references and `using` statements to Microsoft.Data.SqlClient.
1616

17-
There are a few differences in less-used APIs compared to System.Data.SqlClient that may affect some applications. For those differences, see this useful [porting cheat sheet](https://github.com/dotnet/SqlClient/blob/main/porting-cheat-sheet.md).
17+
There are a few differences in less-used APIs compared to System.Data.SqlClient that may affect some applications. For those differences, refer to the useful [porting cheat sheet](https://github.com/dotnet/SqlClient/blob/main/porting-cheat-sheet.md).
1818

1919
## API reference
2020

2121
The Microsoft.Data.SqlClient API details can be found in the [.NET API Browser](/dotnet/api/microsoft.data.sqlclient).
2222

23+
### Breaking changes in 5.1
24+
25+
- Dropped support for .NET Core 3.1. [#1704](https://github.com/dotnet/SqlClient/pull/1704) [#1823](https://github.com/dotnet/SqlClient/pull/1823)
26+
27+
### New features in 5.1
28+
29+
- Added support for `DateOnly` and `TimeOnly` for `SqlParameter` value and `GetFieldValue`. [#1813](https://github.com/dotnet/SqlClient/pull/1813)
30+
- Added support for TLS 1.3 for .NET Core and SNI Native. [#1821](https://github.com/dotnet/SqlClient/pull/1821)
31+
- Added `ServerCertificate` setting for `Encrypt=Mandatory` or `Encrypt=Strict`. [#1822](https://github.com/dotnet/SqlClient/pull/1822) [Read more](#server-certificate)
32+
- Added Windows ARM64 support when targeting .NET Framework. [#1828](https://github.com/dotnet/SqlClient/pull/1828)
33+
34+
### Server Certificate
35+
36+
The default value of the `ServerCertificate` connection setting is an empty string. When `Encrypt` is set to `Mandatory` or `Strict`, `ServerCertificate` can be used to specify a path on the file system to a certificate file to match against the server's TLS/SSL certificate. The certificate specified must be an exact match to be valid. The accepted certificate formats are `PEM`, `DER`, and `CER`. Here's a usage example:
37+
38+
```cs
39+
"Data Source=...;Encrypt=Strict;ServerCertificate=C:\\certificates\\server.cer"
40+
```
41+
42+
## 5.1 Target platform support
43+
44+
- .NET Framework 4.6.2+ (Windows x86, Windows x64)
45+
- .NET 6.0+ (Windows x86, Windows x64, Windows ARM64, Windows Azure Resource Manager, Linux, macOS)
46+
- .NET Standard 2.0+ (Windows x86, Windows x64, Windows ARM64, Windows ARM, Linux, macOS)
47+
48+
Full release notes, including dependencies, are available in the GitHub Repository: [5.1 Release Notes](https://github.com/dotnet/SqlClient/tree/main/release-notes/5.1).
49+
2350
## Release notes for Microsoft.Data.SqlClient 5.0
2451

2552
### Breaking changes in 5.0

docs/connect/ado-net/sqlclient-driver-support-lifecycle.md

Lines changed: 16 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: SqlClient driver support lifecycle
33
description: Product support lifecycle information for the Microsoft.Data.SqlClient .NET library.
44
author: David-Engel
55
ms.author: v-davidengel
6-
ms.date: 01/10/2023
6+
ms.date: 01/11/2023
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: conceptual
@@ -27,7 +27,8 @@ New stable (GA) releases are published every six months on a regular cadence beg
2727

2828
| Version | Official Release Date | Latest Patch Version | Patch Release Date | Support Level | End of Support |
2929
|--|--|--|--|--|--|
30-
| 5.0 | July 29, 2022 | 5.0.1 | October 11, 2022 | Current | - |
30+
| 5.1 | January 19, 2023 | - | - | LTS | January 20, 2026 |
31+
| 5.0 | July 29, 2022 | 5.0.1 | October 11, 2022 | Current | July 19, 2023 |
3132
| 4.1 | January 31, 2022 | 4.1.1 | September 13, 2022 | Current | January 29, 2023 |
3233
| 4.0 | November 18, 2021 | 4.0.2 | September 13, 2022 | LTS | November 19, 2024 |
3334
| 3.1 | March 30, 2022 | 3.1.1 | August 12, 2022 | LTS | March 30, 2025 |
@@ -64,16 +65,18 @@ Current releases are supported for three months after a subsequent Current or LT
6465

6566
## SQL version compatibility with Microsoft.Data.SqlClient
6667

67-
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|
68-
|---|---|---|---|---|---|---|---|---|
69-
|5.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
70-
|4.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
71-
|4.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
72-
|3.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
73-
|2.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
74-
|2.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
75-
|1.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
76-
|1.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
68+
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2022|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|
69+
|---|---|---|---|---|---|---|---|---|---|
70+
|5.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
71+
|5.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
72+
|4.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
73+
|4.0|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
74+
|3.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
75+
|3.0|No|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
76+
|2.1|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
77+
|2.0|No|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
78+
|1.1|No|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
79+
|1.0|No|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|
7780

7881
## Supported OS versions
7982

@@ -85,7 +88,7 @@ Microsoft.Data.SqlClient supports all operating systems supported by .NET Framew
8588

8689
### Support for .NET Core applications
8790

88-
Microsoft.Data.SqlClient supports all operating systems supported by .NET Core v3.1 and above.
91+
Microsoft.Data.SqlClient supports all operating systems supported by .NET 6 and above.
8992

9093
[.NET Core supported OS lifecycle policy](https://github.com/dotnet/core/blob/master/os-lifecycle-policy.md).
9194

docs/linux/quickstart-install-connect-suse.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This quickstart shows how to install SQL Server on SUSE Linux Enter
44
author: VanMSFT
55
ms.author: vanto
66
ms.reviewer: randolphwest
7-
ms.date: 12/21/2022
7+
ms.date: 01/18/2023
88
ms.service: sql
99
ms.subservice: linux
1010
ms.topic: conceptual
@@ -102,7 +102,9 @@ To configure [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] on SLES,
102102
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
103103
```
104104

105-
1. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
105+
1. Before you install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)], and after you have registered and activated your SUSE Linux Enterprise Server with SUSE Customer Center, you must activate both the [Desktop Applications module and Development Tools module](https://documentation.suse.com/sles/15-SP3/html/SLES-all/cha-register-sle.html). These modules are required for some of the [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)] package dependencies.
106+
107+
1. Now, you are ready to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]. Run the following commands to install [!INCLUDE [ssnoversion-md](../includes/ssnoversion-md.md)]:
106108

107109
```bash
108110
sudo zypper install -y mssql-server

docs/sql-server/azure-arc/assess.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,9 @@ The Environment Health assessment is replaced with a much richer best practices
2929
> [!NOTE]
3030
> Best practices assessment is currently limited to SQL Server running on Windows machines. This will not work for SQL on Linux machines.
3131
32-
- [A Log Analytics workspace](/azure/azure-monitor/logs/quick-create-workspace?tabs=azure-portal) in the same subscription as your Arc-enabled SQL Server resource to upload assessment results to.
32+
- Make sure that the version of Azure Extension for SQL Server (`WindowsAgent.SqlServerI`) is "**1.1.2202.47**" or above. Learn how to [check the **Azure Extension for SQL Server** version and update to the latest.](/azure/azure-arc/servers/manage-vm-extensions-portal#upgrade-extensions)
3333

34+
- [A Log Analytics workspace](/azure/azure-monitor/logs/quick-create-workspace?tabs=azure-portal) in the same subscription as your Arc-enabled SQL Server resource to upload assessment results to.
3435
- The user configuring SQL BPA must have following permissions.
3536

3637
- Log Analytics Contributor role on Resource Group or Subscription of the Log Analytics workspace.
@@ -52,8 +53,7 @@ Resource group or Subscription of Arc Machine.
5253

5354
- The [SQL Server browser service](../../tools/configuration-manager/sql-server-browser-service.md) must be running if you're operating a named instance of SQL Server.
5455

55-
- Upgrade the Azure SQL Server extension version. Use the latest version from the [release notes](/sql/sql-server/azure-arc/release-notes). You can upgrade to latest version by updating the extension, in the extension management of Arc-Server. For details, see [Upgrade extensions](/en-us/azure/azure-arc/servers/manage-vm-extensions-portal#upgrade-extensions).
56-
56+
5757
## Enable best practices assessment
5858

5959
1. Sign into the [Azure portal](https://portal.azure.com/) and go to your [Arc-enabled SQL Server resource](https://portal.azure.com/#view/Microsoft_Azure_HybridCompute/AzureArcCenterBlade/~/sqlServers)

0 commit comments

Comments
 (0)