ApsaraDB for SelectDB:ワークロードグループ

概要

ワークロードグループは、単一のコンピューティングノード上のワークロードグループ内のタスクによるコンピューティングリソースとメモリリソースの使用を制限することにより、コンピューティングクラスター内のタスクのリソース使用量を制限します。

高負荷のクエリとインポートタスクがいつ実行されるかを制御でき、コンピューティングクラスターのリソースを最大限に活用したいビジネスシナリオでは、タスクを個別のワークロードグループに関連付けることができます。たとえば、SelectDB のスケジュールされたオフラインコンピューティングタスクを個別のワークロードグループに関連付けることができます。さらに、ビジネスに定期的なピーク時間がある場合は、ワークロードグループを使用してビジネスタスクのリソースを分離することもできます。

ビジネスシナリオに基づいて、次のディメンションからリソースを分離するためにワークロードグループを使用できます。

• 大規模クエリと小規模クエリのリソースを分離します。

• 長時間クエリと短時間クエリのリソースを分離します。

• コールドデータとホットデータに対するクエリのリソースを分離します。

• オフラインおよびリアルタイムのインポートタスクのリソースを分離します。

ワークロードグループの使用

このセクションでは、ワークロードグループの作成、削除、変更、および表示の方法について説明します。

ワークロードグループの作成

次のステートメントを実行して、ワークロードグループを作成できます。 ワークロードグループを使用して、コンピューティングクラスター内の CPU とメモリリソースを分離できます。

構文

CREATE WORKLOAD GROUP [IF NOT EXISTS] 'rg_name'
PROPERTIES (
    property_list
);

パラメーター

次の表に、PROPERTIES のパラメーターを示します。

例

g1 という名前のワークロードグループを作成します。

 CREATE WORKLOAD GROUP IF NOT EXISTS g1
 PROPERTIES (
     "cpu_share"="10",
     "memory_limit"="30%",
     "enable_memory_overcommit"="true"
 );

ワークロードグループの削除

次のステートメントを実行して、ワークロードグループを削除できます。

構文

DROP WORKLOAD GROUP [IF EXISTS] 'rg_name'

例

g1 という名前のワークロードグループを削除します。

DROP WORKLOAD GROUP IF EXISTS g1;

ワークロードグループの変更

次のステートメントを実行して、ワークロードグループを変更できます。

構文

ALTER WORKLOAD GROUP  "rg_name"
PROPERTIES (
    property_list
);

パラメーター

PROPERTIES のパラメーターの詳細については、このトピックのパラメーターセクションを参照してください。

例

g1 という名前のワークロードグループを変更します。

ALTER WORKLOAD GROUP g1
PROPERTIES (
    "cpu_share"="30",
    "memory_limit"="30%"
);

ワークロードグループの表示

次のステートメントを実行して、現在のユーザーが USAGE-PRIV 権限を持っているワークロードグループを表示できます。

構文

SHOW WORKLOAD GROUPS;

例

すべてのワークロードグループを表示します。

mysql> SHOW WORKLOAD GROUPS;
+----------+--------+--------------------------+---------+
| Id       | Name   | Item                     | Value   |
+----------+--------+--------------------------+---------+
| 10343386 | normal | cpu_share                | 10      |
| 10343386 | normal | memory_limit             | 30%     |
| 10343386 | normal | enable_memory_overcommit | true    |
| 10352416 | g1     | memory_limit             | 20%     |
| 10352416 | g1     | cpu_share                | 10      |
+----------+--------+--------------------------+---------+

完全な例

次の例は、SelectDB クラスターでワークロードグループ機能を有効にし、ワークロードグループを使用する方法を示しています。

1. FE 構成項目 enable_workload_group を true に設定します。

enable_workload_group=true

2. ワークロードグループを作成します。

CREATE WORKLOAD GROUP IF NOT EXISTS g1
properties (
    "cpu_share"="10",
    "memory_limit"="30%",
    "enable_memory_overcommit"="true"
);

3. セッション変数 experimental_enable_pipeline_engine を true に設定して、パイプライン実行エンジンを有効にします。 ワークロードグループの CPU 分離は、パイプライン実行エンジンに基づいて実装されます。

set experimental_enable_pipeline_engine = true;

4. クエリをワークロードグループに関連付けて、ワークロードグループに指定されたリソース制限を有効にします。 次のいずれかの方法を使用して、クエリをワークロードグループに関連付けることができます。

• ユーザー プロパティ default_workload_group を構成して、デフォルトのワークロードグループを指定します。 デフォルトのワークロードグループがシステムによって自動的に作成される場合、このプロパティのデフォルト値は normal です。

  set property 'default_workload_group' = 'g1';

  上記のステートメントは、現在のユーザーのクエリで使用されるデフォルトのワークロードグループとして g1 を指定します。

• セッション変数 workload_group を構成して、使用するワークロードグループを指定します。 この変数はデフォルトでは空です。

  set workload_group = 'g1';

  セッション変数 workload_group の優先度は、ユーザー プロパティ default_workload_group よりも高くなります。 workload_group 変数が空の場合、クエリは default_workload_group プロパティで指定されたワークロードグループに関連付けられます。 workload_group 変数が空でない場合、クエリは workload_group 変数で指定されたワークロードグループに関連付けられます。

  管理者でない場合は、最初に SHOW WORKLOAD GROUPS ステートメントを実行して、使用するワークロードグループを表示できるかどうかを確認する必要があります。 ワークロードグループが表示されない場合は、ワークロードグループが存在しないか、ワークロードグループを使用する権限がない可能性があります。 この場合、クエリを実行するとエラーが報告されます。

5. クエリを実行します。 クエリは、指定されたワークロードグループに関連付けられます。 この場合、ワークロードグループに指定されたリソース制限が有効になります。