テキストベースの Query Profile の可視化分析
このトピックでは、MySQL クライアントを使用してテキストベースの Query Profile を取得し、分析する方法を紹介します。
ANALYZE PROFILE を使用して既存のクエリのプロファイルを分析する
クラスター内の既存の（履歴または実行中の）クエリのテキストベースのプロファイルを分析するには、まず SHOW PROFILELIST ステートメントを使用してクエリの概要を取得する必要があります。このコマンドは、正常に終了したクエリ、エラーで失敗したクエリ、およびまだ実行中（10 秒以上経過しているが終了していない）のクエリを一覧表示します。このステートメントを通じて、後続の分析のための対応する Query ID を取得できます。構文は次のとおりです。
SHOW PROFILELIST [LIMIT <num>];
例:
SHOW PROFILELIST;
SHOW PROFILELIST LIMIT 5;
出力:
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+
| QueryId | StartTime | Time | State | Statement |
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+
| a40456b2-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:18 | 21ms | Finished | SELECT ROUTINE_NAME FROM INFORMATION_SCHEMA.ROUTINES\n WHERE ROUTINE_TYPE="FUNCTION" AND ROUTINE_SCHEMA = "None" |
| a3fc4060-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 39ms | Finished | select TABLE_NAME, COLUMN_NAME from information_schema.columns\n where table_schema = 'Non ... |
| a3f7d38d-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 15ms | Finished | select connection_id() |
| a3efbd3b-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:17 | 16ms | Finished | select connection_id() |
| a26ec286-8428-11ee-8d02-6a32f8c68848 | 2023-11-16 10:34:15 | 269ms | Error | EXPLAIN ANALYZE SELECT c_nation, s_nation, year(lo_orderdate) AS year , SUM(lo_revenue) AS revenue FROM lineorder_flat WHERE ... |
+--------------------------------------+---------------------+-------+----------+-----------------------------------------------------------------------------------------------------------------------------------+
Query ID を取得したら、ANALYZE PROFILE ステートメントを使用して Query Profile の分析を進めることができます。構文は次のとおりです。
ANALYZE PROFILE FROM '<Query_ID>' [, <Node_ID> [, ...] ]
Query_ID:SHOW PROFILELISTステートメントから取得したクエリに対応する ID。Node_ID: プロファイルノード ID。ID が指定されたノードについては、StarRocks はそのノードの詳細なメトリック情報を返します。ID が指定されていないノードについては、StarRocks は要約情報のみを返します。
プロファイルには次のセクションが含まれます。
- Summary: プロファイルの要約情報。
- QueryID
- バージョン情報
- クエリのステータス（
Finished、Error、Runningを含む） - クエリの総時間
- メモリ使用量
- CPU 使用率が最も高い上位 10 ノード
- メモリ使用率が最も高い上位 10 ノード
- デフォルト値と異なる値を持つセッション変数
- Fragments: 各フラグメント内の各ノードのメトリクスを表示
- 各ノードの時間、メモリ使用量、コスト推定情報、出力行
- 時間使用率が 30% を超えるノードは赤で強調表示
- 時間使用率が 15% を超え、30% 未満のノードはピンクで強調表示
例 1: ノード ID を指定せずに Query Profile をクエリ。
例 2: ノード ID を 0 と指定して Query Profile をクエリ。StarRocks はノード ID 0 のすべての詳細メトリクスを返し、問題の特定を容易にするために高使用率のメトリクスを強調表示します。
さらに、上記の方法は、実行中のクエリに対して生成されたプロファイルである Runtime Query Profile の表示と分析もサポートしています。Query Profile 機能が有効になっている場合、この方法を使用して 10 秒以上実行中のクエリのプロファイルを取得できます。
終了したクエリのものと比較して、実行中のクエリのテキストベースの Query Profile には次の情報が含まれます。
-
オペレーターのステータス:
- ⏳: オペレーターが開始されていない。これらのオペレーターは依存関係のために実行が開始されていない可能性があります。
- 🚀: 実行中のオペレーター。
- ✅: 実行が終了したオペレーター。
-
全体の進捗:
実行が終了したオペレーターの数 / オペレーターの総数に基づいて計算されます。データ行の詳細情報が不足しているため、この値は若干歪む可能性があります。 -
オペレーターの進捗:
処理された行数 / 行の総数に基づいて計算されます。行の総数を計算できない場合、進捗は?と表示されます。
例:
EXPLAIN ANALYZE を使用してプロファイル分析のためのクエリをシミュレートする
StarRocks は EXPLAIN ANALYZE ステートメントを提供しており、クエリのプロファイルを直接シミュレートして分析することができます。構文は次のとおりです。
EXPLAIN ANALYZE <sql_statement>
EXPLAIN ANALYZE を実行すると、StarRocks はデフォルトで現在のセッションに対して Query Profile 機能を有効にします。
現在、EXPLAIN ANALYZE は 2 種類の SQL ステートメントをサポートしています: SELECT ステートメントと INSERT INTO ステートメント。StarRocks のデフォルトカタログ内の内部テーブルに対する INSERT INTO ステートメントの Query Profile のシミュレーシ ョンと分析のみが可能です。INSERT INTO ステートメントの Query Profile をシミュレートして分析する際には、実際のデータはロードされません。データ分析中に意図しない変更が行われないように、デフォルトでインポートトランザクションは中止されます。
例 1: SELECT ステートメントをシミュレートして分析。クエリ結果は破棄されます。
例 2: INSERT INTO ステートメントをシミュレートして分析。ロードトランザクションは中止されます。
制限事項
EXPLAIN ANALYZE INSERT INTOステートメントはデフォルトカタログ内のテーブルに対してのみサポートされています。- より良い視覚効果を得るために、出力テキストには色付け、ハイライト、その他の機能を提供するために ANSI 文字が含まれています。MyCLI クライアントの使用を推奨します。ANSI 機能をサポートしていないクライアント（例えば MySQL クライアント）では、表示が若干乱れることがありますが、通常は使用に影響を与えません。例えば:
