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/t-sql/statements/alter-workload-group-transact-sql.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: "ALTER WORKLOAD GROUP (Transact-SQL) | Microsoft Docs"
3
3
ms.custom: ""
4
-
ms.date: "01/19/2016"
4
+
ms.date: "01/04/2018"
5
5
ms.prod: "sql-non-specified"
6
6
ms.prod_service: "sql-database"
7
7
ms.service: ""
@@ -36,7 +36,6 @@ ms.workload: "Inactive"
36
36
## Syntax
37
37
38
38
```
39
-
40
39
ALTER WORKLOAD GROUP { group_name | "default" }
41
40
[ WITH
42
41
([ IMPORTANCE = { LOW | MEDIUM | HIGH } ]
@@ -55,32 +54,30 @@ ALTER WORKLOAD GROUP { group_name | "default" }
55
54
Is the name of an existing user-defined workload group or the Resource Governor default workload group.
56
55
57
56
> [!NOTE]
58
-
> Resource Governor creates the "default" and internal groups when [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] is installed.
57
+
> Resource Governor creates the "default" and internal groups when [!INCLUDE[ssNoVersion](../../includes/ssnoversion-md.md)] is installed.
59
58
60
59
The option "default" must be enclosed by quotation marks ("") or brackets ([]) when used with ALTER WORKLOAD GROUP to avoid conflict with DEFAULT, which is a system reserved word. For more information, see [Database Identifiers](../../relational-databases/databases/database-identifiers.md).
61
60
62
61
> [!NOTE]
63
-
> Predefined workload groups and resource pools all use lowercase names, such as "default". This should be taken into account for servers that use case-sensitive collation. Servers with case-insensitive collation, such as SQL_Latin1_General_CP1_CI_AS, will treat "default" and "Default" as the same.
62
+
> Predefined workload groups and resource pools all use lowercase names, such as "default". This should be taken into account for servers that use case-sensitive collation. Servers with case-insensitive collation, such as SQL_Latin1_General_CP1_CI_AS, will treat "default" and "Default" as the same.
64
63
65
64
IMPORTANCE = { LOW | MEDIUM | HIGH }
66
65
Specifies the relative importance of a request in the workload group. Importance is one of the following:
67
66
68
67
- LOW
69
-
70
68
- MEDIUM (default)
71
-
72
69
- HIGH
73
70
74
71
> [!NOTE]
75
-
> Internally each importance setting is stored as a number that is used for calculations.
72
+
> Internally each importance setting is stored as a number that is used for calculations.
76
73
77
74
IMPORTANCE is local to the resource pool; workload groups of different importance inside the same resource pool affect each other, but do not affect workload groups in another resource pool.
78
75
79
76
REQUEST_MAX_MEMORY_GRANT_PERCENT =*value*
80
77
Specifies the maximum amount of memory that a single request can take from the pool. This percentage is relative to the resource pool size specified by MAX_MEMORY_PERCENT.
81
78
82
79
> [!NOTE]
83
-
> The amount specified only refers to query execution grant memory.
80
+
> The amount specified only refers to query execution grant memory.
84
81
85
82
*value* must be 0 or a positive integer. The allowed range for *value* is from 0 through 100. The default setting for *value* is 25.
86
83
@@ -103,7 +100,10 @@ ALTER WORKLOAD GROUP { group_name | "default" }
103
100
Specifies the maximum amount of CPU time, in seconds, that a request can use. *value* must be 0 or a positive integer. The default setting for *value* is 0, which means unlimited.
104
101
105
102
> [!NOTE]
106
-
> Resource Governor will not prevent a request from continuing if the maximum time is exceeded. However, an event will be generated. For more information, see [CPU Threshold Exceeded Event Class](../../relational-databases/event-classes/cpu-threshold-exceeded-event-class.md).
103
+
> By default, Resource Governor will not prevent a request from continuing if the maximum time is exceeded. However, an event will be generated. For more information, see [CPU Threshold Exceeded Event Class](../../relational-databases/event-classes/cpu-threshold-exceeded-event-class.md).
104
+
105
+
> [!IMPORTANT]
106
+
> Starting with [!INCLUDE[ssSQL17](../../includes/sssql17-md.md)] CU3, and using [trace flag 2422](../../t-sql/database-console-commands/dbcc-traceon-trace-flags-transact-sql.md), Resource Governor will abort a request when the maximum time is exceeded.
107
107
108
108
REQUEST_MEMORY_GRANT_TIMEOUT_SEC =*value*
109
109
Specifies the maximum time, in seconds, that a query can wait for memory grant (work buffer memory) to become available.
0 commit comments