Query Profile 概要
このトピックでは、Query Profile の表示と分析方法を紹介します。Query Profile は、クエリに関与するすべての作業ノードの実行情報を記録します。Query Profile を通じて、クエリパフォーマンスに影響を与えるボトルネックを迅速に特定できます。
Query Profile の有効化
Query Profile は、変数 enable_profile を true に設定することで有効化できます。
SET enable_profile = true;
遅いクエリに対する Query Profile の有効化
本番環境で Query Profile をグローバルかつ長期間にわたって有効化することは推奨されません。これは、Query Profile のデータ収集と処理がシステムに追加の負担をかける可能性があるためです。しかし、遅いクエリをキャプチャして分析する必要がある場合は、遅いクエリに対してのみ Query Profile を有効化できます。これは、変数 big_query_profile_threshold を 0s より大きい時間に設定することで実現できます。例えば、この変数を 30s に設定すると、実行時間が 30 秒を超えるクエリのみが Query Profile をトリガーします。これにより、システムパフォーマンスを確保しつつ、遅いクエリを効果的に監視できます。
-- 30 秒
SET global big_query_profile_threshold = '30s';
-- 500 ミリ秒
SET global big_query_profile_threshold = '500ms';
-- 60 分
SET global big_query_profile_threshold = '60m';
ランタイム Query Profile の有効化
一部のクエリは、数秒から数時間にわたって実行されることがあります。多くの場合、クエリがまだ進行中なのか、システムがクラッシュしたのかを判断するのは難しいです。この問題に対処するために、StarRocks は v3.1 以降でランタイム Query Profile 機能を導入しました。この機能により、クエリ実行中に固定時間間隔で Query Profile データを収集し、報告できます。これにより、クエリの実行進捗や潜在的なボトルネックをリアルタイムで把握でき、クエリが終了するのを待たずに監視と最適化が可能になります。
Query Profile が有効化されると、この機能は自動的にアクティブになり、デフォルトの報告間隔は 10 秒です。この間隔は、変数 runtime_profile_report_interval を変更することで調整できます。
SET runtime_profile_report_interval = 30;
ランタイム Query Profile は、通常の Query Profile と同じ形式と内容を持ちます。クラスター内で実行中のクエリのパフォーマンス指標を理解するために、ランタイム Query Profile を通常の Query Profile と同様に分析できます。
Query Profile の動作を設定する
| 設定タイプ | 設定項目 | 有効な値 | デフォルト値 | 説明 |
|---|---|---|---|---|
| セッション変数 | enable_profile | true/false | false | Query Profile を有効にするかどうか。true はこの機能を有効にすることを意味します。 |
| セッション変数 | pipeline_profile_level | 1/2 | 1 | Query Profile のレベルを設定します。1 は Query Profile のメトリクスをマージすることを示し、2 は Query Profile の元の構造を保持することを示します。この項目を 2 に設定すると、すべての可視化分析ツールが適用されなくなるため、一般的にはこの値を変更することは推奨されません。 |
| セッション変数 | runtime_profile_report_interval | 正の整数 | 10 | ランタイム Query Profile の報告間隔。単位: 秒。 |
| セッション変数 | big_query_profile_threshold | 文字列 | 0s | 大規模クエリの実行時間がこの値を超える場合、そのクエリに対して Query Profile が自動的に有効になります。この項目を 0s に設定すると、この機能は無効になります。その値は、単位が ms、s、m の整数で表すことができます。 |
| FE 動的設定項目 | enable_statistics_collect_profile | true/false | false | 統計収集関連のクエリに対して Query Profile を有効にするかどうか。true はこの機能を有効にすることを意味します。 |
Web UI を通じて Query Profile を取得する
次の手順に従って Query Profile を取得します。
- ブラウザで
http://<fe_ip>:<fe_http_port>にアクセスします。 - 表示されたページで、上部ナビゲーションの queries をクリックします。
- Finished Queries リストで、分析したいクエリを選択し、Profile 列のリンクをクリックします。
選択した Query Profile の詳細ページにリダイレクトされます。
get_query_profile を通じて Query Profile を取得する
次の例は、関数 get_query_profile を通じて Query Profile を取得する方法を示しています。
-- プロファイリング機能を有効にします。
set enable_profile = true;
-- シンプルなクエリを実行します。
select 1;
-- クエリの query_id を取得します。
select last_query_id();
+--------------------------------------+
| last_query_id() |
+--------------------------------------+
| bd3335ce-8dde-11ee-92e4-3269eb8da7d1 |
+--------------------------------------+
-- クエリプロファイルを取得します。
select get_query_profile('502f3c04-8f5c-11ee-a41f-b22a2c00f66b')\G
Query Profile の分析
Query Profile によって生成される生の内容には、多数のメトリクスが含まれる場合があります。これらのメトリクスの詳細な説明については、Query Profile Structure and Detailed Metrics を参照してください。
しかし、多くのユーザーはこの生のテキストを直接分析するのが難しいと感じるかもしれません。この問題に対処するために、StarRocks は Text-based Query Profile Visualized Analysis メソッドを提供しています。この機能を使用して、複雑な Query Profile をより直感的に理解できます。