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)