リソースグループの変更
ALTER RESOURCE GROUP
ステートメントは、データベース内のリソース グループを変更するために使用されます。
注記:
この機能はTiDB サーバーレスクラスターでは使用できません。
あらすじ
- AlterResourceGroupStmt
- IfExists
- ResourceGroupName
- ResourceGroupOptionList
- DirectResourceGroupOption
- ResourceGroupPriorityOption
AlterResourceGroupStmt ::=
"ALTER" "RESOURCE" "GROUP" IfExists ResourceGroupName ResourceGroupOptionList
IfExists ::=
('IF' 'EXISTS')?
ResourceGroupName ::=
Identifier
ResourceGroupOptionList ::=
DirectResourceGroupOption
| ResourceGroupOptionList DirectResourceGroupOption
| ResourceGroupOptionList ',' DirectResourceGroupOption
DirectResourceGroupOption ::=
"RU_PER_SEC" EqOpt stringLit
| "PRIORITY" EqOpt ResourceGroupPriorityOption
| "BURSTABLE"
ResourceGroupPriorityOption ::=
LOW
| MEDIUM
| HIGH
TiDB は次のDirectResourceGroupOption
サポートします。ここでリクエストユニット (RU) 、CPU、IO、およびその他のシステム リソースに対する TiDB 内の統合抽象化ユニットです。
オプション | 説明 | 例 |
---|---|---|
RU_PER_SEC | 1 秒あたりの RU バックフィルの速度 | RU_PER_SEC = 500 、このリソース グループが 1 秒あたり 500 RU でバックフィルされていることを示します |
PRIORITY | TiKV 上で処理されるタスクの絶対的な優先度 | PRIORITY = HIGH 優先度が高いことを示します。指定しない場合、デフォルト値はMEDIUM です。 |
BURSTABLE | BURSTABLE 属性が設定されている場合、TiDB は、クォータを超過したときに、対応するリソース グループが利用可能なシステム リソースを使用することを許可します。 |
注記:
ALTER RESOURCE GROUP
ステートメントは、グローバル変数tidb_enable_resource_control
ON
に設定されている場合にのみ実行できます。
例
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 = 100
BURSTABLE;
Query OK, 0 rows affected (0.08 sec)
SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';
+------+------------+----------+-----------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE |
+------+------------+----------+-----------+
| rg1 | 100 | MEDIUM | YES |
+------+------------+----------+-----------+
1 rows in set (1.30 sec)
ALTER RESOURCE GROUP rg1
RU_PER_SEC = 200
PRIORITY = LOW;
Query OK, 0 rows affected (0.08 sec)
SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';
+------+------------+----------+-----------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE |
+------+------------+----------+-----------+
| rg1 | 200 | LOW | NO |
+------+------------+----------+-----------+
1 rows in set (1.30 sec)
MySQLの互換性
MySQL はリソースグループの変更もサポートします。ただし、受け入れられるパラメータが TiDB とは異なるため、互換性はありません。