DROP RESOURCE GROUP

You can use the DROP RESOURCE GROUP statement to drop a resource group.

Note

This feature is not available on TiDB Serverless clusters.

Synopsis

DropResourceGroupStmt

IfExists

ResourceGroupName

DropResourceGroupStmt ::=
    "DROP" "RESOURCE" "GROUP" IfExists ResourceGroupName
IfExists ::=
    ('IF' 'EXISTS')?
ResourceGroupName ::=
    Identifier
|   "DEFAULT"

Note

• The DROP RESOURCE GROUP statement can only be executed when the global variable tidb_enable_resource_control is set to ON.
• The default resource group is reserved and cannot be dropped.

Examples

Drop a resource group named rg1.

DROP RESOURCE GROUP IF EXISTS rg1;

Query OK, 0 rows affected (0.22 sec)

CREATE RESOURCE GROUP IF NOT EXISTS rg1 RU_PER_SEC = 500 BURSTABLE;

Query OK, 0 rows affected (0.08 sec)

SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';

+------+------------+----------+-----------+-------------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT |
+------+------------+----------+-----------+-------------+
| rg1  | 500        | MEDIUM   | YES       | NULL        |
+------+------------+----------+-----------+-------------+
1 row in set (0.01 sec)

DROP RESOURCE GROUP IF EXISTS rg1;

Query OK, 1 rows affected (0.09 sec)

SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';

Empty set (0.00 sec)

MySQL compatibility

MySQL also supports DROP RESOURCE GROUP, but TiDB does not support the FORCE parameter.

See also

• ALTER RESOURCE GROUP
• CREATE RESOURCE GROUP
• Request Unit (RU)