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
Drops an existing user-defined Resource Governor workload group.
2
+
3
+
![Topic link icon](../database-engine/configure-windows/media/topic-link.gif"Topic link icon")[Transact-SQL Syntax Conventions](../t-sql/language-elements/transact-sql-syntax-conventions-transact-sql.md).
4
+
5
+
## Syntax
6
+
7
+
```syntaxsql
8
+
DROP WORKLOAD GROUP group_name
9
+
[;]
10
+
```
11
+
12
+
## Arguments
13
+
14
+
*group_name*
15
+
Is the name of an existing user-defined workload group.
16
+
17
+
## Remarks
18
+
19
+
The DROP WORKLOAD GROUP statement is not allowed on the Resource Governor internal or default groups.
20
+
21
+
When you are executing DDL statements, we recommend that you be familiar with Resource Governor states. For more information, see [Resource Governor](../relational-databases/resource-governor/resource-governor.md).
22
+
23
+
If a workload group contains active sessions, dropping or moving the workload group to a different resource pool will fail when the ALTER RESOURCE GOVERNOR RECONFIGURE statement is called to apply the change. To avoid this problem, you can take one of the following actions:
24
+
25
+
- Wait until all the sessions from the affected group have disconnected, and then rerun the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
26
+
27
+
- Explicitly stop sessions in the affected group by using the KILL command, and then rerun the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
28
+
29
+
- Restart the server. After the restart process is completed, the deleted group will not be created, and a moved group will use the new resource pool assignment.
30
+
31
+
- In a scenario in which you have issued the DROP WORKLOAD GROUP statement but decide that you do not want to explicitly stop sessions to apply the change, you can re-create the group by using the same name that it had before you issued the DROP statement, and then move the group to the original resource pool. To apply the changes, run the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
32
+
33
+
## Permissions
34
+
35
+
Requires CONTROL SERVER permission.
36
+
37
+
## Examples
38
+
39
+
The following example drops the workload group named `adhoc`.
In the following row, click whichever product name you're interested in. The click displays different content here on this webpage, appropriate for whichever product you click.
> |**_\* SQL Server \*_** |[SQL Database<br />managed instance](drop-workload-group-transact-sql.md?view=azuresqldb-mi-current)|[Azure Synapse<br />Analytics](drop-workload-group-transact-sql.md?view=azure-sqldw-latest)|
29
+
||||
30
+
|---|---|---|
31
+
|**_\* SQL Server \*_** |[SQL Database<br />managed instance](drop-workload-group-transact-sql.md?view=azuresqldb-mi-current)|[Azure Synapse<br />Analytics](drop-workload-group-transact-sql.md?view=azure-sqldw-latest)|
32
+
||||
32
33
33
34
34
35
35
36
## SQL Server and SQL Database managed instance
36
37
37
-
Drops an existing user-defined Resource Governor workload group.
38
-
39
-
![Topic link icon](../../database-engine/configure-windows/media/topic-link.gif"Topic link icon")[Transact-SQL Syntax Conventions](../../t-sql/language-elements/transact-sql-syntax-conventions-transact-sql.md).
40
-
41
-
## Syntax
42
-
43
-
```syntaxsql
44
-
DROP WORKLOAD GROUP group_name
45
-
[;]
46
-
```
47
-
48
-
## Arguments
49
-
50
-
*group_name*
51
-
Is the name of an existing user-defined workload group.
52
-
53
-
## Remarks
54
-
55
-
The DROP WORKLOAD GROUP statement is not allowed on the Resource Governor internal or default groups.
56
-
57
-
When you are executing DDL statements, we recommend that you be familiar with Resource Governor states. For more information, see [Resource Governor](../../relational-databases/resource-governor/resource-governor.md).
58
-
59
-
If a workload group contains active sessions, dropping or moving the workload group to a different resource pool will fail when the ALTER RESOURCE GOVERNOR RECONFIGURE statement is called to apply the change. To avoid this problem, you can take one of the following actions:
60
-
61
-
- Wait until all the sessions from the affected group have disconnected, and then rerun the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
62
-
63
-
- Explicitly stop sessions in the affected group by using the KILL command, and then rerun the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
64
-
65
-
- Restart the server. After the restart process is completed, the deleted group will not be created, and a moved group will use the new resource pool assignment.
66
-
67
-
- In a scenario in which you have issued the DROP WORKLOAD GROUP statement but decide that you do not want to explicitly stop sessions to apply the change, you can re-create the group by using the same name that it had before you issued the DROP statement, and then move the group to the original resource pool. To apply the changes, run the ALTER RESOURCE GOVERNOR RECONFIGURE statement.
Drops a workload group. Once the statement completes, the settings are in effect.
106
67
107
68
![Topic link icon](../../database-engine/configure-windows/media/topic-link.gif"Topic link icon")[Transact-SQL Syntax Conventions](../../t-sql/language-elements/transact-sql-syntax-conventions-transact-sql.md).
0 commit comments