Query Profile 概要
このトピックでは、Query Profile の表示と分析方法を紹介します。Query Profile は、クエリに関与するすべての作業ノードの実行情報を記録します。Query Profile を通じて、クエリパフォーマンスに影響を与えるボトルネックを迅速に特定できます。
v3.3.0 以降、StarRocks は INSERT INTO FILES() および Broker Load を使用したデータロードのための Query Profile の提供をサポートしています。関連するメトリクスの詳細については、OlapTableSink Operator を参照してください。
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 以降で Runtime Query Profile 機能を導入しました。この機能により、クエリ実行中に固定時間間隔で Query Profile データを収集し、報告することができます。これにより、クエリの実行進捗と潜在的なボトルネックをリアルタイムで把握でき、クエリが終了するのを待たずに監視と最適化が可能になります。
Query Profile が有効になっている場合、この機能は自動的に有効化され、デフォルトの報告間隔は 10 秒です。この間隔は、変数 runtime_profile_report_interval を変更することで調整できます。
SET runtime_profile_report_interval = 30;
Runtime Query Profile は、通常の Query Profile と同じ形式と内容を持っています。クラスター内で実行中のクエリのパフォーマンスメトリクスを理解するために、通常の Query Profile を分析するのと同様に Runtime 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 | Runtime 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 をより直感的に理解することができます。