You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/relational-databases/backup-restore/configure-backup-compression-sql-server.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ ms.author: mathoma
18
18
19
19
## Use integrated acceleration and offloading
20
20
21
-
Beginning with [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)], use [Integrated offloading and acceleration](../integrated-acceleration/overview.md) to compress backups with Intel QuickAssist Technology.
21
+
Beginning with [!INCLUDE [sssql22-md](../../includes/sssql22-md.md)], use [Integrated offloading and acceleration](../integrated-acceleration/overview.md) to compress backups with Intel® QuickAssist Technology.
22
22
23
23
## Override the Backup Compression Default
24
24
You can change the backup compression behavior for an individual backup, backup job, or log shipping configuration.
This article explains Intel QuickAssist Technology (QAT) for SQL Server and how to configure it on an instance of SQL Server. Intel QAT is an integrated offloading and acceleration solution. For background about these types of solutions, see [Integrated offloading and acceleration](overview.md).
17
+
This article explains Intel® QuickAssist Technology (QAT) for SQL Server and how to configure it on an instance of SQL Server. Intel® QAT is an integrated offloading and acceleration solution. For background about these types of solutions, see [Integrated offloading and acceleration](overview.md).
18
18
19
19
## Edition specific capabilities
20
20
21
-
Intel QAT accelerator is supported starting with [!INCLUDE[sssql22-md](../../includes/sssql22-md.md)] on Windows.
21
+
Intel® QAT accelerator is supported starting with [!INCLUDE[sssql22-md](../../includes/sssql22-md.md)] on Windows.
22
22
23
-
- Enterprise edition supports hardware offloading - requires an Intel QAT device. If no device is available, it falls back to software based compression.
23
+
- Enterprise edition supports hardware offloading - can use a physical device. If no device is available, it falls back to software based compression.
24
24
25
-
- Standard edition supports software compression. Standard edition does not offload to hardware even if an Intel QAT device is available.
25
+
- Standard edition supports software compression. Standard edition does not offload to hardware even if a device is available.
26
26
27
-
- Express edition will allow Intel QAT 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.
27
+
- Express edition allow Intel® QAT 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.
28
28
29
29
> [!NOTE]
30
-
> QAT hardware is not required to successfully restore a previously compressed Intel QAT backup, regardless of the SQL Server edition. However, to back up or restore databases with Intel QAT accelerated compression, you must install Intel QAT drivers.
30
+
> Hardware is not required to successfully restore a previously compressed Intel® QAT backup, regardless of the SQL Server edition. However, to back up or restore databases with Intel® QAT accelerated compression, you must install product drivers.
31
31
32
32
## Install drivers
33
33
34
34
1. Download the drivers.
35
35
36
-
The minimum QATzip accelerator library version supported is [1.8.0-0010](https://www.intel.com/content/www/us/en/download/19732/), but you should always install the latest version from Intel. Drivers are available at [Intel Quick Assist Technology landing page](https://developer.intel.com/quickassist).
36
+
The minimum QATzip accelerator library version supported is [1.8.0-0010](https://www.intel.com/content/www/us/en/download/19732/), but you should always install the latest version from the vendor. Drivers are available at [Intel® Quick Assist Technology landing page](https://developer.intel.com/quickassist).
37
37
38
-
1. Follow the instructions from Intel to install the drivers on your server.
38
+
1. Follow the instructions from the vendor to install the drivers on your server.
39
39
40
40
1. Reboot the server after you install the drivers.
41
41
@@ -60,25 +60,25 @@ For detailed instructions and examples, see [Enable integrated offloading and ac
60
60
61
61
## Service start - after configuration
62
62
63
-
After the feature is enabled, every time the SQL Server service starts, the SQL Server process looks for the required user space software library that interfaces with the hardware acceleration device driver API and loads the software assemblies if they are available. For the Intel QuickAssist Technology (QAT) accelerator, the user space library is QATzip. This library provides a number of features. The QATzip software library is a user space software API that can interface with the QAT kernel driver API. It is used primarily by applications that are looking to accelerate the compression and decompression of files using one or more Intel QAT devices.
63
+
After the feature is enabled, every time the SQL Server service starts, the SQL Server process looks for the required user space software library that interfaces with the hardware acceleration device driver API and loads the software assemblies if they are available. For the Intel®QAT accelerator, the user space library is QATzip. This library provides a number of features. The QATzip software library is a user space software API that can interface with the QAT kernel driver API. It is used primarily by applications that are looking to accelerate the compression and decompression of files using one or more Intel® QAT devices.
64
64
65
65
In the case of the Windows operating system, there is a complimentary software library to QATzip, the Intel Intelligent Storage Library (ISA-L). This serves as a software fallback mechanism for QATzip in the case of hardware failure, and a software-based option when the hardware is not available.
66
66
67
67
> [!NOTE]
68
-
> The unavailability of an Intel QAT hardware device doesn't prevent instances from performing backup or restore operations using the QAT_DEFLATE algorithm. If the physical device is not available, the software algorithm will be leveraged as a fallback solution.
68
+
> The unavailability of an Intel® QAT hardware device doesn't prevent instances from performing backup or restore operations using the QAT_DEFLATE algorithm. If the physical device is not available, the software algorithm will be leveraged as a fallback solution.
69
69
70
70
## Backup operation
71
71
72
72
[!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] introduces an `ALGORITHM` extension for backup compression for [BACKUP (Transact-SQL)](../../t-sql/statements/backup-transact-sql.md#compression).
73
73
74
-
The T-SQL BACKUP command WITH COMPRESSION has been extended to allow for a specified backup compression algorithm. When using Intel QAT for backup compression acceleration, the algorithm QAT_DEFLATE initiates an Intel QAT compressed backup if the drivers are available and the SQL Server configuration has been completed successfully as illustrated in the previously documented steps.
74
+
The T-SQL BACKUP command WITH COMPRESSION has been extended to allow for a specified backup compression algorithm. When using Intel® QAT for backup compression acceleration, the algorithm QAT_DEFLATE initiates an Intel® QAT compressed backup if the drivers are available and the SQL Server configuration has been completed successfully as illustrated in the previously documented steps.
75
75
76
76
> [!NOTE]
77
77
> The standard compression algorithm is MS_XPRESS and is default compression option.
78
78
79
79
Use the ALGORITHM command to specify either of these two algorithms (`MS_XPRESS`, `QAT_DEFLATE`) for backup compression.
80
80
81
-
The example below performs backup compression using Intel QAT hardware acceleration.
81
+
The example below performs backup compression using Intel® QAT hardware acceleration.
82
82
83
83
```sql
84
84
BACKUP DATABASE <database> TO DISK ='<path>\<file>.bak'
@@ -138,7 +138,7 @@ RECONFIGURE;
138
138
139
139
No restart of SQL Server is required for this change to take effect.
140
140
141
-
The 'configure backup compression algorithm' configuration sets the default compression algorithm. To set Intel QAT as the default compression algorithm for SQL Server, use the following script:
141
+
The 'configure backup compression algorithm' configuration sets the default compression algorithm. To set Intel® QAT as the default compression algorithm for SQL Server, use the following script:
@@ -172,9 +172,9 @@ SQL Server backups compressed using QAT_DEFLATE support all T-SQL RESTORE operat
172
172
Auxiliary RESTORE commands are also supported for all backup compression algorithms. Auxiliary RESTORE commands include RESTORE FILELISTONLY, RESTORE HEADERONLY, RESTORE VERIFYONLY, and more.
173
173
174
174
> [!NOTE]
175
-
> If the server-scope configuration `HARDWARE_OFFLOAD` option is not enabled, and/or the Intel QAT drivers have not been installed, SQL Server returns error 17441 instead of attempting to perform the restore. For example: `Msg 17441, Level 16, State 1, Line 175 This operation requires Intel(R) QuickAssist Technology (QAT) libraries to be loaded.`
175
+
> If the server-scope configuration `HARDWARE_OFFLOAD` option is not enabled, and/or the Intel® QAT drivers have not been installed, SQL Server returns error 17441 instead of attempting to perform the restore. For example: `Msg 17441, Level 16, State 1, Line 175 This operation requires Intel(R) QuickAssist Technology (QAT) libraries to be loaded.`
176
176
177
-
To restore an Intel QAT compressed backup, the correct assemblies must be loaded on the SQL Server instance initiating the restore operation.
177
+
To restore an Intel® QAT compressed backup, the correct assemblies must be loaded on the SQL Server instance initiating the restore operation.
This article explains offloading and acceleration to hardware devices.
20
20
21
-
-[!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] integrates [Intel 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 QuickAssist Technology (QAT) to reduce CPU usage, backup completion times, and reduce storage consumption. To back up or restore databases with Intel QAT accelerated compression, you must install Intel QAT drivers. For specific information and instructions to use Intel QAT with SQL Server, see [Configure Intel QuickAssist Technology (QAT)](intel-quickassist.md).
21
+
-[!INCLUDE [sssql22-md](../../includes/sssql22-md.md)] integrates [Intel® 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®QAT to reduce CPU usage, backup completion times, and reduce storage consumption. To back up or restore databases with accelerated compression, install Intel® QAT drivers. For specific information and instructions to use with SQL Server, see [Configure Intel® QuickAssist Technology (QAT)](intel-quickassist.md).
22
22
23
23
## Use case - Backup and restore operations
24
24
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 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 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® 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.
26
26
27
27
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).
28
28
@@ -49,14 +49,14 @@ Changing this configuration option requires a restart of SQL Server service to t
49
49
> [!NOTE]
50
50
> If `hardware offload enabled` option equals `0`, all offloading and acceleration is disabled, however the accelerator-specific configurations will persist.
51
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 QAT.
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® QAT.
53
53
54
54
```sql
55
55
ALTER SERVER CONFIGURATION
56
56
SET HARDWARE_OFFLOAD =ON (ACCELERATOR = QAT);
57
57
```
58
58
59
-
If your instance is Enterprise Edition, and you have the Intel 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.
59
+
If your instance is Enterprise Edition, and you have the Intel® 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
60
61
61
```sql
62
62
ALTER SERVER CONFIGURATION
@@ -72,7 +72,7 @@ Changing this configuration option requires a restart of SQL Server service to t
72
72
73
73
## Disable offloading and acceleration
74
74
75
-
The following example disables hardware offloading and acceleration for an Intel QAT accelerator.
75
+
The following example disables hardware offloading and acceleration for an Intel® QAT accelerator.
76
76
77
77
```sql
78
78
ALTER SERVER CONFIGURATION
@@ -87,6 +87,6 @@ Integrated offloading and acceleration requires Windows operating system. It is
0 commit comments