:ApsaraDB for ClickHouseのリソースキュー

背景情報

オープンソースのClickHouseはリソースキューをサポートしていません。 V20.8以降のApsaraDB For ClickHouseクラスターのクエリの複雑さの制限については、「クエリの複雑さの制限」をご参照ください。

リソースキューは、ApsaraDB for ClickHouseの拡張機能であり、V20.3のApsaraDB for ClickHouseクラスターでのみサポートされます。 オープンソースのClickHouseは、ユーザーレベルのメモリ分離メカニズムを提供します。 ApsaraDB for ClickHouseクラスターを購入すると、デフォルトではリソースキュー機能は有効になりません。

リソースキューの構文

次のサンプル構文は、リソースキューを管理する方法を示しています。

-- リソースキューを作成します。
CREATE RESOURCE QUEUE [存在しない場合 | OR REPLACE] name [ON CLUSTER cluster]
  * {[SET] MEMORY = {number}
  * [, CONCURRENCY = {number}]
  * [, PRIORITY = { LOWEST | LOW | NORMAL | HIGH | HIGHEST }]
  * [, ISOLATE = {number}]
    * }
  * [TO {role [,...] | ALL | ALL | ALL EXCEPT role [,...]}]

-- 指定されたリソースキューを変更します。
ALTER RESOURCE QUEUE [存在しない場合 | OR REPLACE] name [ON CLUSTER cluster]
  * {[SET] MEMORY = {number}
  * [, CONCURRENCY = {number}]
  * [, PRIORITY = { LOWEST | LOW | NORMAL | HIGH | HIGHEST }]
  * [, ISOLATE = {number}]
    * }
  * [TO {role [,...] | ALL | ALL | ALL EXCEPT role [,...]}]

-- 指定されたリソースキューを照会します。
SHOW CREATEリソースキュー名

-- 使用しているリソースキューを照会します。
SHOW CREATEリソースキューcurrent

-- 指定したリソースキューを削除します。
DROPリソースキューが存在する場合は名前 

次のサンプルコードでは、リソースキューの管理方法の例を示します。

リソースキューを作成します 
  メモリ=1073741824、懸念=20、アイソレート=0、優先度=正常 
    にデフォルト;

クラスタークラスターSETでanonymous_queueが存在しない場合にリソースキューを作成する 
  MEMORY = 1073741824、CONCURRENCY = 20、ISOLATE = 1、PRIORITY = LOW;

SHOW CREATEリソースキューtest_queue;

現在のリソースキューを作成します。SELECT count (distinct intDiv(number、10)) FROM numbers(100000) 設定target_resource_queue='anonymous_queue';

存在する場合はDROPリソースキューtest_queue;

DROPリソースキューが存在する場合anonymous_queue; 

リソースキューに関する情報の照会

show resource queues;

次の表に、クエリ結果のパラメーターを示します。

show resource queue stat [CURRENT | ALL];

次の表に、クエリ結果のパラメーターを示します。

リソースキューでクエリを実行するときに発生する可能性のあるエラー

• 同時クエリの数が同時実行制限を超えたため、クエリがタイムアウトしました

  • エラーコード: 13005
  • 解決策: クライアントでの同時クエリの数を減らします。

• 悪いクエリで使用されるメモリのサイズがメモリプールのサイズを超えています

  • エラーコード: 241
  • 解決策: クエリプランを最適化するか、リソースキューに割り当てられるメモリプールのサイズを大きくします。

• クエリが強制的にルーティングされる指定されたリソースキューが存在しません

  • エラーコード: 13006
  • 解決策: 指定されたリソースキューが作成されているかどうかを確認します。

• 優先度の低いリソースキューのメモリを一時的にプリエンプトしたクエリは終了します

  • エラーコード: 394
  • 解決策: 使用するリソースキュー内の同時クエリの数を減らし、リソースキューの優先順位を変更します。