DSCResources/DSC_SqlMaxDop/en-US/about_SqlMaxDop.help.txt
|
.NAME
SqlMaxDop .DESCRIPTION The SqlMaxDop DSC resource set the max degree of parallelism server configuration option. The max degree of parallelism option is used to limit the number of processors to use in parallel plan execution. Read more about max degree of parallelism in this article https://msdn.microsoft.com/en-us/library/ms189094.aspx > [!IMPORTANT] > This configuration option can also be configured using the DSC > resource SqlConfiguration but will not allow the dynamic configuration > as this resource provides. Make sure this value is not configured by both > the resources SqLMaxDop and SqlConfiguration! ## Formula for dynamically allocating max degree of parallelism * If the number of configured NUMA nodes configured in SQL Server equals 1, then max degree of parallelism is calculated using number of cores divided in 2 (numberOfCores / 2), then rounded up to the next integer (3.5 > 4). * If the number of cores configured in SQL Server are greater than or equal to 8 cores then max degree of parallelism will be set to 8. * If the number of configured NUMA nodes configured in SQL Server is greater than 2 and the number of cores are less than 8 then max degree of parallelism will be set to the number of cores. ## Requirements * Target machine must be running Windows Server 2012 or later. * Target machine must be running SQL Server Database Engine 2012 or later. ## Known issues All issues are not listed here, see https://github.com/dsccommunity/SqlServerDsc/issues?q=is%3Aissue+is%3Aopen+in%3Atitle+SqlMaxDop. .PARAMETER Ensure Write - String Allowed values: Present, Absent When set to 'Present' then max degree of parallelism will be set to either the value in parameter MaxDop or dynamically configured when parameter DynamicAlloc is set to $true. When set to 'Absent' max degree of parallelism will be set to 0 which means no limit in number of processors used in parallel plan execution. .PARAMETER DynamicAlloc Write - Boolean If set to $true then max degree of parallelism will be dynamically configured. When this is set parameter is set to $true, the parameter MaxDop must be set to $null or not be configured. .PARAMETER MaxDop Write - SInt32 A numeric value to limit the number of processors used in parallel plan execution. .PARAMETER ServerName Write - String The host name of the SQL Server to be configured. Default value is the current computer name. .PARAMETER InstanceName Key - String The name of the SQL instance to be configured. .PARAMETER ProcessOnlyOnActiveNode Write - Boolean Specifies that the resource will only determine if a change is needed if the target node is the active host of the SQL Server instance. .PARAMETER IsActiveNode Read - Boolean Determines if the current node is actively hosting the SQL Server instance. .EXAMPLE 1 This example shows how to set max degree of parallelism server configuration option with the value equal to 1. Configuration Example { param ( [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $SqlAdministratorCredential ) Import-DscResource -ModuleName 'SqlServerDsc' node localhost { SqlMaxDop 'Set_SqlMaxDop_ToOne' { Ensure = 'Present' DynamicAlloc = $false MaxDop = 1 ServerName = 'sqltest.company.local' InstanceName = 'DSC' PsDscRunAsCredential = $SqlAdministratorCredential } } } .EXAMPLE 2 This example shows how to set max degree of parallelism server configuration option with the automatic configuration. In the event this is applied to a Failover Cluster Instance (FCI), the ProcessOnlyOnActiveNode property will tell the Test-TargetResource function to evaluate if any changes are needed if the node is actively hosting the SQL Server instance. Configuration Example { param ( [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $SqlAdministratorCredential ) Import-DscResource -ModuleName 'SqlServerDsc' node localhost { SqlMaxDop 'Set_SqlMaxDop_ToAuto' { Ensure = 'Present' DynamicAlloc = $true ServerName = 'sqltest.company.local' InstanceName = 'DSC' PsDscRunAsCredential = $SqlAdministratorCredential ProcessOnlyOnActiveNode = $true } } } .EXAMPLE 3 This example shows how to set max degree of parallelism server configuration option with the default configuration. Configuration Example { param ( [Parameter(Mandatory = $true)] [System.Management.Automation.PSCredential] $SqlAdministratorCredential ) Import-DscResource -ModuleName 'SqlServerDsc' node localhost { SqlMaxDop 'Set_SqlMaxDop_ToDefault' { Ensure = 'Absent' ServerName = 'sqltest.company.local' InstanceName = 'DSC' PsDscRunAsCredential = $SqlAdministratorCredential } } } |