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

Commit 1e3d05f

Browse files
committed
Merge branch '20220824-qat-configure' of https://github.com/MikeRayMSFT/sql-docs-pr into 20220824-qat-configure
2 parents 18a505f + 11e1b20 commit 1e3d05f

14 files changed

Lines changed: 213 additions & 109 deletions

.openpublishing.redirection.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41280,6 +41280,11 @@
4128041280
"redirect_url": "/sql/sql-server/",
4128141281
"redirect_document_id": false
4128241282
},
41283+
{
41284+
"source_path": "docs/relational-databases/integrated-acceleration/intel-quickassist.md",
41285+
"redirect_url": "/sql/relational-databases/integrated-acceleration/use-integrated-acceleration-and-offloading",
41286+
"redirect_document_id": false
41287+
},
4128341288
{
4128441289
"source_path": "docs/relational-databases/system-catalog-views/sys-sql-feature-restrictions.md",
4128541290
"redirect_url": "/sql/sql-server/what-s-new-in-sql-server-ver15",

docs/database-engine/configure-windows/hardware-offload-enable-configuration-option.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Hardware offload enable server configuration option | Microsoft Docs"
2+
title: "Hardware offload enabled server configuration option | Microsoft Docs"
33
description: 'Learn about the "hardware offload enabled" option. '
44
ms.custom: ""
55
ms.date: 08/17/2022
@@ -20,9 +20,7 @@ ms.author: mikeray
2020

2121
[!INCLUDE [sqlserver2022](../../includes/applies-to-version/sqlserver2022.md)]
2222

23-
The `hardware offload enabled` configuration option allows integrated offloading and acceleration with validated solutions from partners. For more information, see [Integrated offloading and acceleration](../../relational-databases/integrated-acceleration/overview.md).
24-
25-
This is an advanced option.
23+
The `hardware offload enabled` configuration option allows integrated acceleration and offloading with validated solutions from partners. For more information, see [Integrated acceleration and offloading](../../relational-databases/integrated-acceleration/overview.md).
2624

2725
Changing option requires a restart.
2826

docs/database-engine/configure-windows/server-configuration-options-sql-server.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,7 @@ The following table lists all available configuration options, the range of poss
110110
| [automatic soft-NUMA disabled](soft-numa-sql-server.md) | 0 | 1 | 0 |
111111
| [backup checksum default](backup-checksum-default.md) | 0 | 1 | 0 |
112112
| [backup compression default](view-or-configure-the-backup-compression-default-server-configuration-option.md) | 0 | 1 | 0 |
113+
| [backup compression algorithm](view-or-configure-the-backup-compression-algorithm-server-configuration-option.md) (A)<br /><br />**Applies to:** [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] and later. | 0 | 1 | 0 |
113114
| [blocked process threshold](blocked-process-threshold-server-configuration-option.md) (A) | 5 | 86400 | 0 |
114115
| [c2 audit mode](c2-audit-mode-server-configuration-option.md) (A, RR) | 0 | 1 | 0 |
115116
| [clr enabled](clr-enabled-server-configuration-option.md) | 0 | 1 | 0 |
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: "View or Configure the backup compression algorithm Server Configuration Option | Microsoft Docs"
3+
description: 'Find out about the "backup compression algorithm" option. See how it determines the algorithm to use for backup compression, and learn how to set it.'
4+
ms.custom: ""
5+
ms.date: "08/24/2022"
6+
ms.prod: sql
7+
ms.reviewer: ""
8+
ms.technology: configuration
9+
ms.topic: conceptual
10+
helpviewer_keywords:
11+
- "backup compression algorithm [SQL Server], backup compression algorithm Option"
12+
author: MikeRayMSFT
13+
ms.author: mikeray
14+
---
15+
16+
# View or configure the backup compression algorithm Server Configuration Option
17+
18+
[!INCLUDE [SQL Server 2022](../../includes/applies-to-version/sqlserver2022.md)]
19+
20+
This topic describes how to view or configure the **backup compression algorithm** server configuration option in [!INCLUDE[ssnoversion](../../includes/ssnoversion-md.md)] with [!INCLUDE[tsql](../../includes/tsql-md.md)]. The **backup compression algorithm** option determines which algorithm to use to set the backup.
21+
22+
The `backup compression algorithm` configuration option is required for you to implement [integrated acceleration and offloading solutions](../../relational-databases/integrated-acceleration/use-integrated-acceleration-and-offloading.md).
23+
24+
## <a name="BeforeYouBegin"></a> Before You Begin
25+
26+
### <a name="Restrictions"></a> Limitations and Restrictions
27+
28+
- [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)].
29+
- Requires Windows Operating System
30+
31+
### <a name="Security"></a> Security
32+
33+
#### <a name="Permissions"></a> Permissions
34+
35+
Execute permissions on **sp_configure** with no parameters or with only the first parameter are granted to all users by default. To execute **sp_configure** with both parameters to change a configuration option or to run the RECONFIGURE statement, a user must be granted the ALTER SETTINGS server-level permission. The ALTER SETTINGS permission is implicitly held by the **sysadmin** and **serveradmin** fixed server roles.
36+
37+
## To view the backup compression algorithm option
38+
39+
1. Connect to the [!INCLUDE[ssDE](../../includes/ssde-md.md)].
40+
41+
2. From the Standard bar, click **New Query**.
42+
43+
3. Copy and paste the following example into the query window and click **Execute**. This example queries the [sys.configurations](../../relational-databases/system-catalog-views/sys-configurations-transact-sql.md) catalog view to determine the value for `backup compression algorithm`. A value of 0 means that backup compression is off, and a value of 1 means that SQL Server will use the default backup compression algorithm (MS_XPRESS). A value of 2, means that SQL Server will use Intel&reg QAT backup compression algorithm.
44+
45+
```sql
46+
SELECT value
47+
FROM sys.configurations
48+
WHERE name = 'backup compression algorithm' ;
49+
GO
50+
```
51+
52+
## To configure the backup compression default option
53+
54+
1. Connect to the [!INCLUDE[ssDE](../../includes/ssde-md.md)].
55+
56+
2. From the Standard bar, click **New Query**.
57+
58+
3. Copy and paste the following example into the query window and click **Execute**. This example shows how to use [sp_configure](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md) to configure the server instance to use Intel&reg; QAT as the default compression algorithm:
59+
60+
```sql
61+
EXEC sp_configure 'backup compression algorithm', 2;
62+
RECONFIGURE;
63+
```
64+
65+
To change the default compression algorithm back to the default, use the following script:
66+
67+
```sql
68+
EXEC sp_configure 'backup compression algorithm', 1;
69+
RECONFIGURE;
70+
```
71+
72+
For more information, see [Server Configuration Options &#40;SQL Server&#41;](../../database-engine/configure-windows/server-configuration-options-sql-server.md).
73+
74+
## See also
75+
76+
[BACKUP &#40;Transact-SQL&#41;](../../t-sql/statements/backup-transact-sql.md)
77+
[Server Configuration Options &#40;SQL Server&#41;](../../database-engine/configure-windows/server-configuration-options-sql-server.md)
78+
[RECONFIGURE &#40;Transact-SQL&#41;](../../t-sql/language-elements/reconfigure-transact-sql.md)
79+
[sp_configure &#40;Transact-SQL&#41;](../../relational-databases/system-stored-procedures/sp-configure-transact-sql.md)
80+
[Backup Overview &#40;SQL Server&#41;](../../relational-databases/backup-restore/backup-overview-sql-server.md)

docs/relational-databases/backup-restore/configure-backup-compression-sql-server.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,14 @@ author: MashaMSFT
1313
ms.author: mathoma
1414
---
1515
# Configure Backup Compression (SQL Server)
16-
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
17-
At installation, backup compression is off by default. The default behavior for backup compression is defined by the **backup compression default** Option server-level configuration option. However, you can override the server-level default when creating a single backup or scheduling a series of routine backups. To change the server-level default, see [View or Configure the backup compression default Server Configuration Option](../../database-engine/configure-windows/view-or-configure-the-backup-compression-default-server-configuration-option.md).
16+
17+
[!INCLUDE [SQL Server](../../includes/applies-to-version/sqlserver.md)]
18+
19+
At installation, backup compression is off by default. The **backup compression default** server-level configuration option sets the default behavior for backup compression. However, you can override the server-level default when creating a single backup or scheduling a series of routine backups. To change the server-level default, see [View or Configure the backup compression default Server Configuration Option](../../database-engine/configure-windows/view-or-configure-the-backup-compression-default-server-configuration-option.md).
1820

1921
## Use integrated acceleration and offloading
2022

21-
Beginning with [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)], use [Integrated offloading and acceleration](../integrated-acceleration/overview.md) to compress backups with Intel&reg; QuickAssist Technology.
23+
Beginning with [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)], use [Integrated acceleration and offloading](../integrated-acceleration/overview.md) to compress backups with Intel&reg; QuickAssist Technology.
2224

2325
## Override the Backup Compression Default
2426
You can change the backup compression behavior for an individual backup, backup job, or log shipping configuration.
Lines changed: 14 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Integrated offloading & acceleration
2+
title: Integrated acceleration & offloading
33
description: Learn to leverage integrated solutions from third party providers to offload and accelerate workloads for an instance of SQL Server.
44
ms.date: 08/18/2022
55
ms.prod: sql
@@ -10,83 +10,43 @@ ms.author: mikeray
1010
ms.reviewer: david.pless, wiassaf
1111
---
1212

13-
# Integrated offloading and acceleration
13+
# Integrated acceleration and offloading
1414

1515
[!INCLUDE [sqlserver2022](../../includes/applies-to-version/sqlserver2022.md)]
1616

1717
[!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] provides a framework for offloading specific SQL Server workload compute to hardware devices.
1818

1919
This article explains offloading and acceleration to hardware devices.
2020

21-
- [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] integrates [Intel&reg; QuickAssist Technology (QAT)](https://www.intel.com/content/www/us/en/developer/topic-technology/open/quick-assist-technology/overview.html). You can offload backup compression with Intel&reg; QAT to reduce CPU usage, backup completion times, and reduce storage consumption. To back up or restore databases with accelerated compression, install Intel&reg; QAT drivers. For specific information and instructions to use with SQL Server, see [Configure Intel&reg; QuickAssist Technology (QAT)](intel-quickassist.md).
21+
[!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] enables integrated offloading and acceleration with [Intel&reg; QuickAssist Technology (QAT)](https://www.intel.com/content/www/us/en/developer/topic-technology/open/quick-assist-technology/overview.html). You can offload backup compression with Intel&reg; QAT to reduce CPU usage, backup completion times, and reduce storage consumption. To back up or restore databases with accelerated compression, install Intel&reg; QAT drivers. For specific information and instructions to use with SQL Server, see [Configure Intel&reg; QuickAssist Technology (QAT)](use-integrated-acceleration-and-offloading.md).
2222

23-
## Use case - Backup and restore operations
23+
## Back up and restore databases
2424

25-
One use case for integrated offloading and acceleration is [backup compression](../backup-restore/backup-compression-sql-server.md). Compression speeds up backup and restore operations, and saves space. Compression also consumes CPU resources which may impact application performance. Because Intel&reg; QAT is an integrated offloading and acceleration solution, you can use it to back up and restore databases with compression, and reduce the load compression places on the CPU.
25+
One use case for integrated acceleration and offloading is [backup compression](../backup-restore/backup-compression-sql-server.md). Compression speeds up back up and restore operations, and saves space. Compression also consumes CPU resources which may impact application performance. Because Intel&reg; QAT is an integrated acceleration and offloading solution, you can use it to back up and restore databases with compression, and reduce the load compression places on the CPU.
2626

2727
Backup compression is enabled by including the COMPRESSION keyword for BACKUP T-SQL commands, and is now available with an ALGORITHM parameter to choose between MS_XPRESS (default) and QAT_DEFLATE. For information about how to compress backups, see [Configure Backup Compression (SQL Server)](../backup-restore/configure-backup-compression-sql-server.md).
2828

29-
## Enable integrated offloading and acceleration
29+
## Edition specific capabilities
3030

31-
Before you can use integrated offloading and acceleration, you need to configure the instance of SQL Server. Before you complete this section, install the drivers for your accelerator.
31+
Integrated acceleration and offloading are supported starting with [!INCLUDE[sssql22-md](../../includes/sssql22-md.md)] on Windows.
3232

33-
1. Set the server configuration option `hardware offload enabled` to `1` to enable all SQL Server accelerators. By default, this setting is `0`. This setting is an advanced configuration option. To set this setting, run the following commands:
33+
- Enterprise edition supports hardware offloading - can use a physical device. If no device is available, it falls back to software based compression.
3434

35-
```sql
36-
sp_configure 'show advanced options', 1;
37-
GO
38-
RECONFIGURE
39-
GO
40-
41-
sp_configure 'hardware offload enabled', 1;
42-
GO
43-
RECONFIGURE
44-
GO
45-
```
35+
- Standard edition supports software compression. Standard edition does not offload to hardware even if a device is available.
4636

47-
Changing this configuration option requires a restart of SQL Server service to take effect.
37+
- Express edition allows compressed backups to be restored if the drivers are available. All editions lower than SQL Server Standard edition will only allow backups to be performed with the default MS_XPRESS algorithm.
4838

49-
> [!NOTE]
50-
> If `hardware offload enabled` option equals `0`, all offloading and acceleration is disabled, however the accelerator-specific configurations will persist.
51-
52-
1. Configure the server to use hardware offload for a specific accelerator. Run [ALTER SERVER CONFIGURATION](../../t-sql/statements/alter-server-configuration-transact-sql.md) to enable hardware acceleration. The following example sets this configuration for Intel&reg; QAT.
53-
54-
```sql
55-
ALTER SERVER CONFIGURATION
56-
SET HARDWARE_OFFLOAD = ON (ACCELERATOR = QAT);
57-
```
58-
59-
If your instance is Enterprise Edition, and you have the Intel&reg; QAT device installed, it will use hardware by default, with software fallback. If you would prefer to only use software offloading, run the following configuration.
60-
61-
```sql
62-
ALTER SERVER CONFIGURATION
63-
SET HARDWARE_OFFLOAD = ON (ACCELERATOR = QAT, MODE = SOFTWARE)
64-
```
65-
66-
Standard edition only supports software offloading. For more information on edition specifics, see [Edition specific capabilities](intel-quickassist.md#edition-specific-capabilities).
67-
68-
> [!TIP]
69-
> You might specify software mode for your accelerator if you have higher computing resources and prefer higher backup performance over protecting the host systems compute resources.
70-
71-
1. Restart the SQL Server instance. You need to restart the SQL Server instance after you run a command to `SET HARDWARE_OFFLOAD = ...`.
72-
73-
## Disable offloading and acceleration
74-
75-
The following example disables hardware offloading and acceleration for an Intel&reg; QAT accelerator.
76-
77-
```sql
78-
ALTER SERVER CONFIGURATION
79-
SET HARDWARE_OFFLOAD = OFF (ACCELERATOR = QAT);
80-
```
39+
> [!NOTE]
40+
> Hardware is not required to successfully restore a previously compressed backup, regardless of the SQL Server edition. However, to back up or restore databases with accelerated compression, you must install product drivers.
8141
8242
## Limitations
8343

84-
Integrated offloading and acceleration requires Windows operating system. It is not available on Linux or containers.
44+
Integrated acceleration and offloading are not available on Linux or containers.
8545

8646
## Next steps
8747

8848
- [Hardware offload enabled configuration option](../../database-engine/configure-windows/hardware-offload-enable-configuration-option.md)
8949
- [sys.dm_server_accelerator_status (Transact-SQL)](../system-dynamic-management-views/sys-dm-server-accelerator-status-transact-sql.md)
90-
- [Intel&reg; QuickAssist Technology (QAT) for SQL Server](intel-quickassist.md)
50+
- [Use integrated acceleration and offloading solutions](use-integrated-acceleration-and-offloading.md)
9151
- [BACKUP (Transact-SQL)](../../t-sql/statements/backup-transact-sql.md)
9252
- [RESTORE Statements (Transact-SQL)](../../t-sql/statements/restore-statements-transact-sql.md)

0 commit comments

Comments
 (0)