CREATE RESOURCE GROUP

説明

リソースグループを作成します。

詳細については、 Resource group を参照してください。

構文

CREATE RESOURCE GROUP resource_group_name 
TO CLASSIFIER1, CLASSIFIER2, ...
WITH resource_limit

パラメータ

• resource_group_name: 作成するリソースグループの名前。

• CLASSIFIER: リソース制限が課されるクエリをフィルタリングするために使用されるクラシファイア（分類器）。クラシファイアは "key"="value" ペアを使用して指定する必要があります。リソースグループに対して複数のクラシファイアを設定できます。

  クラシファイアのパラメータは以下の通りです：

  パラメータ	必須	説明
  user	いいえ	ユーザーの名前。
  role	いいえ	ユーザーの役割。
  query_type	いいえ	クエリのタイプ。SELECT と INSERT（v2.5から）がサポートされています。query_type が insert のリソースグループに INSERT タスクがヒットすると、BE ノードはタスクのために指定された CPU リソースを予約します。
  source_ip	いいえ	クエリが開始される CIDR ブロック。
  db	いいえ	クエリがアクセスするデータベース。カンマ（,）で区切られた文字列で指定できます。

• resource_limit: リソースグループに課されるリソース制限。リソース制限は "key"="value" ペアを使用して指定する必要があります。リソースグループに対して複数のリソース制限を設定できます。

  リソース制限のパラメータは以下の通りです：

  パラメータ	必須	説明
  cpu_core_limit	いいえ	BE 上でリソースグループに割り当てられる CPU コア数のソフトリミット。実際のビジネスシナリオでは、リソースグループに割り当てられる CPU コアは、BE 上の CPU コアの可用性に基づいて比例的にスケールします。有効な値：0 以外の任意の正の整数。
  mem_limit	いいえ	BE によって提供される総メモリ内でクエリに使用できるメモリの割合。単位：%。有効な値：(0, 1)。
  concurrency_limit	いいえ	リソースグループ内の同時クエリの上限。多くの同時クエリによるシステムの過負荷を避けるために使用されます。
  big_query_cpu_second_limit	いいえ	大規模クエリの CPU 占有時間の上限。同時クエリは時間を加算します。単位は秒。
  big_query_scan_rows_limit	いいえ	大規模クエリによってスキャンされる行数の上限。
  big_query_mem_limit	いいえ	大規模クエリのメモリ使用量の上限。単位はバイト。
  type	いいえ	リソースグループのタイプ。有効な値： short_query: short_query リソースグループからのクエリが実行されている場合、BE ノードは short_query.cpu_core_limit で定義された CPU コアを予約します。すべての normal リソースグループの CPU コアは「総 CPU コア - short_query.cpu_core_limit」に制限されます。 normal: short_query リソースグループからのクエリが実行されていない場合、上記の CPU コア制限は normal リソースグループに課されません。 注意：クラスター内に short_query リソースグループを 1 つだけ作成できます。

例

例 1: 複数のクラシファイアに基づいてリソースグループ rg1 を作成します。

CREATE RESOURCE GROUP rg1
TO 
    (user='rg1_user1', role='rg1_role1', query_type in ('select'), source_ip='192.168.x.x/24'),
    (user='rg1_user2', query_type in ('select'), source_ip='192.168.x.x/24'),
    (user='rg1_user3', source_ip='192.168.x.x/24'),
    (user='rg1_user4'),
    (db='db1')
WITH ('cpu_core_limit' = '10',
      'mem_limit' = '20%',
      'type' = 'normal',
      'big_query_cpu_second_limit' = '100',
      'big_query_scan_rows_limit' = '100000',
      'big_query_mem_limit' = '1073741824'
);