リソースグループを作成する

CREATE RESOURCE GROUPステートメントを使用してリソース グループを作成できます。

注記：

この機能は、 TiDB Cloud StarterおよびTiDB Cloud Essentialインスタンスではご利用いただけません。

あらすじ

CreateResourceGroupStmt ::=
   "CREATE" "RESOURCE" "GROUP" IfNotExists ResourceGroupName ResourceGroupOptionList

IfNotExists ::=
    ('IF' 'NOT' 'EXISTS')?

ResourceGroupName ::=
    Identifier
|   "DEFAULT"

ResourceGroupOptionList ::=
    DirectResourceGroupOption
|   ResourceGroupOptionList DirectResourceGroupOption
|   ResourceGroupOptionList ',' DirectResourceGroupOption

DirectResourceGroupOption ::=
    "RU_PER_SEC" EqOpt stringLit
|   "PRIORITY" EqOpt ResourceGroupPriorityOption
|   "BURSTABLE"
|   "BURSTABLE" EqOpt Boolean
|   "QUERY_LIMIT" EqOpt '(' ResourceGroupRunawayOptionList ')'
|   "QUERY_LIMIT" EqOpt '(' ')'
|   "QUERY_LIMIT" EqOpt "NULL"
|   "BACKGROUND" EqOpt '(' BackgroundOptionList ')'
|   "BACKGROUND" EqOpt '(' ')'
|   "BACKGROUND" EqOpt "NULL"

ResourceGroupPriorityOption ::=
    LOW
|   MEDIUM
|   HIGH

ResourceGroupRunawayOptionList ::=
    DirectResourceGroupRunawayOption
|   ResourceGroupRunawayOptionList DirectResourceGroupRunawayOption
|   ResourceGroupRunawayOptionList ',' DirectResourceGroupRunawayOption

DirectResourceGroupRunawayOption ::=
    "EXEC_ELAPSED" EqOpt stringLit
|   "PROCESSED_KEYS" EqOpt intLit
|   "RU" EqOpt intLit
|   "ACTION" EqOpt ResourceGroupRunawayActionOption
|   "WATCH" EqOpt ResourceGroupRunawayWatchOption WatchDurationOption

WatchDurationOption ::=
    ("DURATION" EqOpt stringLit | "DURATION" EqOpt "UNLIMITED")?

ResourceGroupRunawayWatchOption ::=
    EXACT
|   SIMILAR
|   PLAN

ResourceGroupRunawayActionOption ::=
    DRYRUN
|   COOLDOWN
|   KILL
| "SWITCH_GROUP" '(' ResourceGroupName ')'

リソースグループ名パラメータ（ ResourceGroupName ）は、グローバルに一意である必要があります。

TiDB は、次のDirectResourceGroupOptionをサポートします。ここでリクエストユニット（RU）は、CPU、IO、およびその他のシステム リソースに対する TiDB の統合抽象化ユニットです。

注記：

• CREATE RESOURCE GROUPステートメントは、グローバル変数tidb_enable_resource_controlがONに設定されている場合にのみ実行できます。 TiDB は、クラスタ初期化時にdefaultリソース グループを自動的に作成します。 このリソース グループのRU_PER_SECのデフォルト値はUNLIMITED ( INT型の最大値、つまり2147483647に相当) であり、 BURSTABLEモードです。いずれのリソースグループにも紐付けられていないすべてのリクエストは、自動的にこのdefaultリソースグループに紐付けられます。別のリソースグループの新しい構成を作成する場合は、必要に応じてdefaultリソースグループの構成を変更することをお勧めします。
• 現在、 defaultリソース グループのみがBACKGROUND構成の変更をサポートしています。

例

rg1とrg2 2 つのリソース グループを作成します。

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
  PRIORITY = HIGH
  BURSTABLE;

Query OK, 0 rows affected (0.08 sec)

CREATE RESOURCE GROUP IF NOT EXISTS rg2
  RU_PER_SEC = 200 QUERY_LIMIT=(EXEC_ELAPSED='100ms', ACTION=KILL);

Query OK, 0 rows affected (0.08 sec)

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

+------+------------+----------+-----------+---------------------------------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT                     |
+------+------------+----------+-----------+---------------------------------+
| rg1  | 100        | HIGH     | YES       | NULL                            |
| rg2  | 200        | MEDIUM   | NO        | EXEC_ELAPSED=100ms, ACTION=KILL |
+------+------------+----------+-----------+---------------------------------+
2 rows in set (1.30 sec)

MySQLとの互換性

MySQL はリソースグループを作成するもサポートしています。ただし、受け入れられるパラメータが TiDB とは異なるため、互換性はありません。

関連項目

• リソースグループを削除する
• アルター・リソース・グループ
• ユーザーリソースグループの変更
• リクエストユニット（RU）