DROP RESOURCE GROUP

April 22, 2026 ยท View on GitHub

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

Note:

This feature is not available on {{{ .starter }}} and {{{ .essential }}} instances.

Synopsis

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   | MODERATED      | 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