メインコンテンツまでスキップ
バージョン: 3.1

CREATE RESOURCE GROUP

説明​

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

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

ヒント

この操作には、SYSTEMレベルのCREATE RESOURCE GROUP権限が必要です。 この権限を付与するには、 GRANT の指示に従ってください。

構文​

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

パラメータ​

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

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

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

    ParameterRequiredDescription
    userNoユーザーの名前。
    roleNoユーザーの役割。
    query_typeNoクエリのタイプ。 SELECT と INSERT（v2.5から）がサポートされています。 query_type が insert のリソースグループにINSERTタスクがヒットすると、BEノードはタスクのために指定されたCPUリソースを予約します。
    source_ipNoクエリが開始されるCIDRブロック。
    dbNoクエリがアクセスするデータベース。カンマ（,）で区切られた文字列で指定できます。
    plan_cpu_cost_rangeNoクエリの推定CPUコスト範囲。その値は fe.audit.log の PlanCpuCost フィールドと同等の意味を持ち、単位はありません。フォーマットは [DOUBLE, DOUBLE) です。デフォルト値はNULLで、そのような制限がないことを示します。このパラメータはv3.1.4以降でサポートされています。
    plan_mem_cost_rangeNoクエリの推定メモリコスト範囲。その値は fe.audit.log の PlanMemCost フィールドと同等の意味を持ち、単位はありません。フォーマットは [DOUBLE, DOUBLE) です。デフォルト値はNULLで、そのような制限がないことを示します。このパラメータはv3.1.4以降でサポートされています。

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

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

    ParameterRequiredDescription
    cpu_core_limitNoBE上でリソースグループに割り当てられるCPUコア数のソフトリミット。実際のビジネスシナリオでは、リソースグループに割り当てられるCPUコアは、BE上のCPUコアの可用性に基づいて比例的にスケールします。有効な値：0以外の正の整数。
    mem_limitNoBEが提供する総メモリの中で、クエリに使用できるメモリの割合。単位：%。有効な値：(0, 1)。
    concurrency_limitNoリソースグループ内の同時クエリの上限。過剰な同時クエリによるシステムの過負荷を防ぐために使用されます。
    max_cpu_coresNo単一のBEノードでのこのリソースグループのCPUコア制限。0より大きく設定された場合にのみ有効です。範囲：[0, avg_be_cpu_cores]、ここで avg_be_cpu_cores はすべてのBEノードの平均CPUコア数を表します。デフォルト：0。
    big_query_cpu_second_limitNo大規模クエリのCPU占有の上限時間。同時クエリが時間を加算します。単位は秒。
    big_query_scan_rows_limitNo大規模クエリがスキャンできる行数の上限。
    big_query_mem_limitNo大規模クエリのメモリ使用量の上限。単位はバイト。
    typeNoリソースグループのタイプ。有効な値：
    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'
);