予想以上にリソースを消費するクエリ（ランナウェイクエリ）を管理する

注記：

この機能は、クラスターTiDB CloudスターターおよびTiDB Cloudエッセンシャルでは利用できません。

ランナウェイクエリとは、予想よりも多くの時間やリソースを消費するクエリです。以下では、ランナウェイクエリを管理する機能を説明するために「ランナウェイクエリ」という用語を使用します。

• バージョン7.2.0以降、リソース制御機能にランナウェイクエリの管理機能が導入されました。リソースグループに対してランナウェイクエリを特定するための条件を設定し、ランナウェイクエリによるリソースの枯渇や他のクエリへの影響を防ぐためのアクションを自動的に実行できます。3 またはALTER RESOURCE GROUP CREATE RESOURCE GROUP QUERY_LIMITフィールドを含めることで、リソースグループのランナウェイクエリを管理できます。
• バージョン7.3.0以降、リソース制御機能にランナウェイ・ウォッチの手動管理が導入され、特定のSQL文またはダイジェストに対するランナウェイ・クエリを迅速に特定できるようになりました。ステートメントQUERY WATCH実行することで、リソースグループ内のランナウェイ・クエリ・ウォッチリストを手動で管理できます。

リソース制御機能の詳細については、 リソース制御を使用してリソースグループの制限とフロー制御を実現する参照してください。

QUERY_LIMITパラメータ

クエリが次のいずれかの制限を超えると、ランナウェイ クエリとして識別されます。

• EXEC_ELAPSED : クエリ実行時間が制限を超えていないかどうかを確認します。このルールは、読み取りおよび書き込みDMLステートメントに適用されます。
• PROCESSED_KEYS :コプロセッサーによって処理されるキーの数が制限を超えていないかどうかを確認します。このルールは読み取りステートメントにのみ適用されます。
• RU : ステートメントによって消費される読み取りおよび書き込み RU の合計数が制限を超えているかどうかを確認します。このルールは読み取りステートメントにのみ適用されます。

サポートされている操作（ ACTION ）：

• DRYRUN : アクションは実行されません。ランナウェイクエリのレコードが追加されます。これは主に、条件設定が適切かどうかを観察するために使用されます。
• COOLDOWN : クエリの実行優先度が最低レベルに下げられます。クエリは最低優先度で実行を継続し、他の操作のリソースを占有しません。
• KILL : 識別されたクエリは自動的に終了され、エラーQuery execution was interrupted, identified as runaway queryが報告されます。
• SWITCH_GROUP : v8.4.0 で導入されたこのパラメータは、指定されたクエリを指定されたリソースグループに切り替えて実行を継続します。このクエリが完了すると、後続の SQL 文は元のリソースグループで実行されます。指定されたリソースグループが存在しない場合、クエリは元のリソースグループに残ります。

システムリソースを枯渇させる過剰な同時実行のランナウェイクエリを回避するために、リソース制御機能では、ランナウェイクエリを迅速に識別して分離できる迅速な識別メカニズムを導入しています。 WATCH句を通じてこの機能を使用できます。クエリがランナウェイクエリとして識別されると、このメカニズムはクエリの一致する特徴 ( WATCH後のパラメータで定義) を抽出します。次の期間 ( DURATIONで定義) に、ランナウェイクエリの一致する特徴が監視リストに追加され、TiDB インスタンスはクエリを監視リストと照合します。一致したクエリは、条件によって識別されるのを待たずに、直接ランナウェイクエリとしてマークされ、対応するアクションに従って分離されます。 KILL操作はクエリを終了し、エラーQuarantined and interrupted because of being in runaway watch listを報告します。

WATCH素早く識別するために一致させる方法は 3 つあります。

• EXACT 、まったく同じ SQL テキストを持つ SQL ステートメントのみが迅速に識別されることを示します。
• SIMILAR 、同じパターンを持つすべての SQL ステートメントが SQL ダイジェストに一致し、リテラル値が無視されることを示します。
• PLAN 、同じパターンを持つすべての SQL ステートメントがプラン ダイジェストに一致することを示します。

WATCHのDURATIONオプションは識別項目の有効期間を示し、デフォルトでは無期限です。

監視項目を追加した後、 QUERY_LIMIT設定が変更または削除されても、対応する機能とACTION変更または削除されません。監視項目を削除するにはQUERY WATCH REMOVE使用します。

QUERY_LIMITのパラメータは次のとおりです。

注記：

ランナウェイクエリを特定のリソースグループに厳密に制限したい場合は、 SWITCH_GROUPとQUERY WATCHステートメントを併用することをお勧めします。5 QUERY_LIMIT 、クエリが条件を満たした場合にのみ対応するACTION操作をトリガーするため、このようなシナリオではSWITCH_GROUPクエリを適切なタイミングで対象のリソースグループに切り替えられない可能性があります。

例

1. 1 秒あたり 500 RU のクォータを持つリソース グループrg1を作成し、60 秒を超えるクエリをランナウェイ クエリとして定義し、ランナウェイ クエリの優先度を下げます。

   CREATE RESOURCE GROUP IF NOT EXISTS rg1 RU_PER_SEC = 500 QUERY_LIMIT=(EXEC_ELAPSED='60s', ACTION=COOLDOWN);
   

2. rg1リソース グループを変更して、ランナウェイ クエリを終了し、次の 10 分以内に、同じパターンのクエリをランナウェイ クエリとして直ちにマークします。

   ALTER RESOURCE GROUP rg1 QUERY_LIMIT=(EXEC_ELAPSED='60s', ACTION=KILL, WATCH=SIMILAR DURATION='10m');
   

3. ランナウェイ クエリ チェックをキャンセルするには、 rg1リソース グループを変更します。

   ALTER RESOURCE GROUP rg1 QUERY_LIMIT=NULL;
   

QUERY WATCHパラメータ

QUERY WATCHのあらすじについてはQUERY WATCH参照してください。

パラメータは次のとおりです。

• RESOURCE GROUPリソースグループを指定します。このステートメントによって追加されたランナウェイクエリの一致する特徴は、リソースグループのウォッチリストに追加されます。このパラメータは省略可能です。省略した場合、 defaultリソースグループに適用されます。

• ACTIONの意味はQUERY LIMITと同じです。このパラメータは省略可能です。省略した場合、識別後の対応するアクションは、リソースグループ内のQUERY LIMITで設定されたACTION採用し、 QUERY LIMIT設定によってアクションは変更されません。リソースグループ内にACTIONが設定されていない場合は、エラーが報告されます。

• QueryWatchTextOptionパラメータには、 SQL DIGEST 、 PLAN DIGEST 、 SQL TEXT 3 つのオプションがあります。

  • SQL DIGESTはSIMILARと同じです。以下のパラメータは、文字列、ユーザー定義変数、または文字列を返すその他の式を受け入れます。文字列の長さは64文字でなければなりません。これはTiDBのダイジェスト定義と同じです。
  • PLAN DIGESTはPLANと同じです。次のパラメータはダイジェスト文字列です。
  • SQL TEXT入力SQLを生の文字列（ EXACT ）として一致させるか、次のパラメータに応じてSQL DIGEST （ SIMILAR ）またはPLAN DIGEST （ PLAN ）に解析してコンパイルします。

• デフォルトのリソース グループのランナウェイ クエリ監視リストに一致する機能を追加します (事前にデフォルトのリソース グループにQUERY LIMIT設定する必要があります)。

  QUERY WATCH ADD ACTION KILL SQL TEXT EXACT TO 'select * from test.t2';
  

• SQLをSQLダイジェストに解析することで、リソースグループrg1ランナウェイクエリ監視リストに一致する機能を追加します。3 ACTION指定されていない場合は、リソースグループrg1に既に設定されているオプションACTION使用されます。

  QUERY WATCH ADD RESOURCE GROUP rg1 SQL TEXT SIMILAR TO 'select * from test.t2';
  

• SQL を SQL ダイジェストに解析して、 rg1リソース グループのランナウェイ クエリ監視リストに一致する機能を追加し、 ACTION SWITCH_GROUP(rg2)として指定します。

  QUERY WATCH ADD RESOURCE GROUP rg1 ACTION SWITCH_GROUP(rg2) SQL TEXT SIMILAR TO 'select * from test.t2';
  

• PLAN DIGEST使用してrg1リソース グループのランナウェイ クエリ監視リストに一致する機能を追加し、 ACTION KILLとして指定します。

  QUERY WATCH ADD RESOURCE GROUP rg1 ACTION KILL PLAN DIGEST 'd08bc323a934c39dc41948b0a073725be3398479b6fa4f6dd1db2a9b115f7f57';
  

• INFORMATION_SCHEMA.RUNAWAY_WATCHESクエリしてウォッチ アイテム ID を取得し、ウォッチ アイテムを削除します。

  SELECT * from information_schema.runaway_watches ORDER BY id\G
  

  *************************** 1. row ***************************
                   ID: 1
  RESOURCE_GROUP_NAME: default
           START_TIME: 2024-09-09 03:35:31
             END_TIME: 2024-09-09 03:45:31
                WATCH: Exact
          WATCH_TEXT: SELECT variable_name, variable_value FROM mysql.global_variables
               SOURCE: 127.0.0.1:4000
              ACTION: Kill
              RULE: ProcessedKeys = 666(10)
  1 row in set (0.00 sec)
  

  QUERY WATCH REMOVE 1;
  

可観測性

ランナウェイ クエリに関する詳細情報は、次のシステム テーブルおよびINFORMATION_SCHEMAから取得できます。

• mysql.tidb_runaway_queriesテーブルには、過去 7 日間に特定されたすべてのランナウェイクエリの履歴レコードが含まれています。例として、1 つの行を見てみましょう。

  MySQL [(none)]> SELECT * FROM mysql.tidb_runaway_queries LIMIT 1\G
  *************************** 1. row ***************************
  resource_group_name: default
       start_time: 2024-09-09 17:43:42
          repeats: 2
       match_type: watch
           action: kill
       sample_sql: select sleep(2) from t
       sql_digest: 4adbc838b86c573265d4b39a3979d0a362b5f0336c91c26930c83ab187701a55
      plan_digest: 5d094f78efbce44b2923733b74e1d09233cb446318293492901c5e5d92e27dbc
      tidb_server: 127.0.0.1:4000
  

  フィールドの説明:

  • start_time 、ランナウェイ クエリが識別された時間を示します。
  • repeats 、 start_time以降にランナウェイクエリが識別された回数を示します。
  • match_type 、ランナウェイクエリの識別方法を示します。値は次のいずれかになります。
    • identifyランナウェイクエリの条件に一致することを意味します。
    • watch 、監視リスト内のクイック識別ルールに一致することを意味します。

• information_schema.runaway_watches表には、ランナウェイクエリのクイック識別ルールの記録が含まれています。詳細については、 RUNAWAY_WATCHES参照してください。