sys.resource_governor_workload_groups (Transact-SQL)

Applies to: SQL Server

Returns the stored workload group configuration in SQL Server. Each workload group can subscribe to one and only one resource pool.

Column name Data type Description
group_id int Unique ID of the workload group. Is not nullable.
name sysname Name of the workload group. Is not nullable.
importance sysname Note: Importance only applies to workload groups in the same resource pool.

Is the relative importance of a request in this workload group. Importance is one of the following, with MEDIUM being the default: LOW, MEDIUM, HIGH.

Is not nullable.
request_max_memory_grant_percent int Maximum memory grant, as a percentage, for a single request. The default value is 25. Is not nullable.

Note: If this setting is higher than 50 percent, large queries will run one at a time. Therefore, there is greater risk of getting an out-of-memory error while the query is running.
request_max_cpu_time_sec int Maximum CPU use limit, in seconds, for a single request. The default value, 0, specifies no limit. Is not nullable.

Note: For more information, see CPU Threshold Exceeded Event Class.
request_memory_grant_timeout_sec int Memory grant time-out, in seconds, for a single request. The default value, 0, uses an internal calculation based on query cost. Is not nullable.
max_dop int Maximum degree of parallelism for the workload group. The default value, 0, uses global settings. Is not nullable.

Note: This setting will override the query option maxdop.
group_max_requests int Maximum number of concurrent requests. The default value, 0, specifies no limit. Is not nullable.
pool_id int ID of the resource pool that this workload group uses.
external_pool_id int Applies to: SQL Server 2016 (13.x) and later.

ID of the external resource pool that this workload group uses.
request_max_memory_grant_percent_numeric float Applies to: SQL Server 2019 (15.x) and later.

Maximum memory grant, as a percentage, for a single request. The default value is 25. Is not nullable.

Note: If this setting is higher than 50 percent, large queries will run one at a time. Therefore, there is greater risk of getting an out-of-memory error while the query is running.

Remarks

The catalog view displays the stored metadata. To see the in-memory configuration, use the corresponding dynamic management view, sys.dm_resource_governor_workload_groups (Transact-SQL).

The stored and in-memory configuration can be different if the Resource Governor configuration has been changed but the ALTER RESOURCE GOVERNOR RECONFIGURE statement has not been applied.

Permissions

Requires VIEW ANY DEFINITION permission to view contents, requires CONTROL SERVER permission to change contents.

See Also

sys.dm_resource_governor_workload_groups (Transact-SQL)
Catalog Views (Transact-SQL)
Resource Governor Catalog Views (Transact-SQL)