Configure the max degree of parallelism (server configuration option)
Applies to: SQL Server
This article describes how to configure the max degree of parallelism
(MAXDOP) server configuration option in SQL Server by using SQL Server Management Studio, Azure Data Studio, or Transact-SQL. When an instance of SQL Server runs on a computer that has more than one microprocessor or CPU, the Database Engine detects whether parallelism can be used. The degree of parallelism sets the number of processors employed to run a single statement, for each parallel plan execution. You can use the max degree of parallelism
option to limit the number of processors to use in parallel plan execution. For more detail on the limit set by max degree of parallelism
(MAXDOP), see the Considerations section in this page. SQL Server considers parallel execution plans for queries, index data definition language (DDL) operations, parallel inserts, online alter column, parallel stats collection, and static and keyset-driven cursor population.
Note
SQL Server 2019 (15.x) introduced automatic recommendations for setting the MAXDOP server configuration option based on the number of processors available during the installation process. The setup user interface allows you to either accept the recommended settings or enter your own value. For more information, see Database Engine Configuration - MaxDOP page.
In Azure SQL Database and Azure SQL Managed Instance, the default MAXDOP setting for each new single database, elastic pool database and managed instance is 8. In Azure SQL Database, the MAXDOP database-scoped configuration is set to 8. In Azure SQL Managed Instance, the max degree of parallelism
(MAXDOP) server configuration option is set to 8.
For more on MAXDOP in Azure SQL Database, see Configure the max degree of parallelism (MAXDOP) in Azure SQL Database.
Before You Begin
Considerations
This option is an advanced option and should be changed only by an experienced database administrator or certified SQL Server professional.
If the affinity mask option isn't set to the default, it might restrict the number of processors available to SQL Server on symmetric multiprocessing (SMP) systems.
Setting max degree of parallelism (MAXDOP) to 0 allows SQL Server to use all the available processors up to 64 processors. However, this isn't the recommended value for most cases. For more information on the recommended values for max degree of parallelism, see the Recommendations section in this page.
To suppress parallel plan generation, set
max degree of parallelism
to1
. Set the value to a number from 1 to 32,767 to specify the maximum number of processor cores that can be used during a single query execution. If a value greater than the number of available processors is specified, the actual number of available processors is used. If the computer has only one processor, themax degree of parallelism
value is ignored.The max degree of parallelism limit is set per task. It isn't a per request or per query limit. This means that during a parallel query execution, a single request can spawn multiple tasks up to the MAXDOP limit, and each task will use one worker and one scheduler. For more information, see the Scheduling parallel tasks section in the Thread and Task Architecture Guide.
You can override the max degree of parallelism server configuration value:
- At the query level, using the MAXDOP query hint or Query Store hint.
- At the database level, using the MAXDOP database scoped configuration.
- At the workload level, using the MAX_DOP Resource Governor workload group configuration option.
Index operations that create or rebuild an index, or that drop a clustered index, can be resource intensive. You can override the max degree of parallelism value for index operations by specifying the MAXDOP index option in the index statement. The MAXDOP value is applied to the statement at execution time and isn't stored in the index metadata. For more information, see Configure Parallel Index Operations.
In addition to queries and index operations, this option also controls the parallelism of DBCC CHECKTABLE, DBCC CHECKDB, and DBCC CHECKFILEGROUP. You can disable parallel execution plans for these statements by using Trace Flag 2528. For more information, see Trace Flags (Transact-SQL).
SQL Server 2022 (16.x) introduced Degree of Parallelism (DOP) Feedback, a new feature to improve query performance by identifying parallelism inefficiencies for repeating queries, based on elapsed time and waits. DOP feedback is part of the intelligent query processing family of features, and addresses suboptimal usage of parallelism for repeating queries. For information about DOP feedback, visit Degree of parallelism (DOP) feedback.
Recommendations
Starting with SQL Server 2016 (13.x), during service startup if the Database Engine detects more than eight physical cores per NUMA node or socket at startup, soft-NUMA nodes are created automatically by default. The Database Engine places logical processors from the same physical core into different soft-NUMA nodes. The recommendations in the table below are aimed at keeping all the worker threads of a parallel query within the same soft-NUMA node. This will improve the performance of the queries and distribution of worker threads across the NUMA nodes for the workload. For more information, see Soft-NUMA.
Starting with SQL Server 2016 (13.x), use the following guidelines when you configure the max degree of parallelism
server configuration value:
Server configuration | Number of processors | Guidance |
---|---|---|
Server with single NUMA node | Less than or equal to eight logical processors | Keep MAXDOP at or below # of logical processors |
Server with single NUMA node | Greater than eight logical processors | Keep MAXDOP at 8 |
Server with multiple NUMA nodes | Less than or equal to 16 logical processors per NUMA node | Keep MAXDOP at or below # of logical processors per NUMA node |
Server with multiple NUMA nodes | Greater than 16 logical processors per NUMA node | Keep MAXDOP at half the number of logical processors per NUMA node with a MAX value of 16 |
Note
NUMA node in the above table refers to soft-NUMA nodes automatically created by SQL Server 2016 (13.x) and higher versions, or hardware-based NUMA nodes if soft-NUMA has been disabled. Use these same guidelines when you set the max degree of parallelism option for Resource Governor workload groups. For more information, see CREATE WORKLOAD GROUP (Transact-SQL).
From SQL Server 2008 (10.0.x) through SQL Server 2014 (12.x), use the following guidelines when you configure the max degree of parallelism
server configuration value:
Server configuration | Number of processors | Guidance |
---|---|---|
Server with single NUMA node | Less than or equal to eight logical processors | Keep MAXDOP at or below # of logical processors |
Server with single NUMA node | Greater than eight logical processors | Keep MAXDOP at 8 |
Server with multiple NUMA nodes | Less than or equal to eight logical processors per NUMA node | Keep MAXDOP at or below # of logical processors per NUMA node |
Server with multiple NUMA nodes | Greater than eight logical processors per NUMA node | Keep MAXDOP at 8 |
Security
Permissions
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.
Use SQL Server Management Studio or Azure Data Studio
In Azure Data Studio, install the Database Admin Tool Extensions for Windows
extension, or use the below T-SQL method.
Configure the max degree of parallelism option
These options change the MAXDOP for the instance.
In Object Explorer, right-click the desired instance and select Properties.
Select the Advanced node.
In the Max Degree of Parallelism box, select the maximum number of processors to use in parallel plan execution.
Use Transact-SQL
Configure the max degree of parallelism option with T-SQL
Connect to the Database Engine with SQL Server Management Studio or Azure Data Studio.
From the Standard bar, select New Query.
Copy and paste the following example into the query window and select Execute. This example shows how to use sp_configure to configure the
max degree of parallelism
option to16
.
USE AdventureWorks2022;
GO
EXEC sp_configure 'show advanced options', 1;
GO
RECONFIGURE WITH OVERRIDE;
GO
EXEC sp_configure 'max degree of parallelism', 16;
GO
RECONFIGURE WITH OVERRIDE;
GO
For more information, see Server Configuration Options (SQL Server).
Follow Up: After you configure the max degree of parallelism option
The setting takes effect immediately without restarting the server.
Related content
- Intelligent query processing in SQL databases
- Query processing architecture guide
- DBCC TRACEON - Trace Flags (Transact-SQL)
- Query Store hints
- Hints (Transact-SQL) - Query
- USE HINT query hint
- ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
- affinity mask Server Configuration Option
- Server configuration options (SQL Server)
- Query Processing Architecture Guide
- Thread and task architecture guide
- sp_configure (Transact-SQL)
- Set Index Options
- Degree of parallelism (DOP) feedback
- RECONFIGURE (Transact-SQL)
- Monitor and Tune for Performance
- Configure Parallel Index Operations