TiDBダッシュボードのTop SQLページ

Top SQLを使用すると、データベース内の各 SQL 文の CPU オーバーヘッドをリアルタイムで監視し、視覚的に把握できます。これにより、データベースのパフォーマンス問題の最適化と解決に役立ちます。Top Top SQL は、すべての TiDB および TiKV インスタンスから、任意の秒数における SQL 文ごとにまとめられた CPU 負荷データを継続的に収集し、保存します。収集されたデータは最大 30 日間保存できます。Top Top SQL は、視覚的なグラフと表を表示し、一定期間にわたって TiDB または TiKV インスタンスの CPU 負荷を高めている SQL 文を迅速に特定できるようにします。

Top SQL は次の機能を提供します。

グラフと表を使用して、CPU オーバーヘッドが最も高い上位 5 種類の SQL ステートメントを視覚化します。
1 秒あたりのクエリ数、平均レイテンシー、クエリプランなどの詳細な実行情報を表示します。
まだ実行中のものも含め、実行されたすべての SQL ステートメントを収集します。
特定の TiDB および TiKV インスタンスのデータを表示できるようにします。

推奨シナリオ

Top SQLはパフォーマンスの問題を分析するのに適しています。以下は、 Top SQLの典型的なシナリオです。

Grafanaのチャートから、クラスター内の個々のTiKVインスタンスのCPU使用率が非常に高いことがわかりました。どのSQL文がCPUホットスポットを引き起こしているかを把握することで、それらを最適化し、分散リソース全体をより有効に活用したいと考えています。
クラスター全体のCPU使用率が非常に高く、クエリの実行速度が遅いことがわかりました。どのSQL文が最もCPUリソースを消費しているかを迅速に把握し、最適化したいと考えています。
クラスターの CPU 使用率が大幅に変化したため、その主な原因を知りたいと考えています。
クラスター内で最もリソースを消費する SQL ステートメントを分析し、最適化してハードウェアコストを削減します。

Top SQL は次のシナリオでは使用できません。

Top SQL は、不正なデータや異常なクラッシュなど、パフォーマンス以外の問題を正確に特定するために使用することはできません。
Top SQL は、トランザクションロックの競合など、CPU の高負荷が原因ではないデータベースパフォーマンスの問題の分析をサポートしていません。

ページにアクセスする

次のいずれかの方法で「Top SQL」ページにアクセスできます。

TiDB ダッシュボードにログインしたら、左側のナビゲーションメニューで[Top SQL]をクリックします。
ブラウザでhttp://127.0.0.1:2379/ダッシュボード/#/topsqlアクセスしてください。3 127.0.0.1:2379実際のPDインスタンスのアドレスとポートに置き換えてください。

Top SQLを有効にする

注記：
Top SQLを使用するには、クラスターを最新バージョンのTiUP （v1.9.0 以上）またはTiDB Operator （v1.3.0 以上）でデプロイまたはアップグレードする必要があります。以前のバージョンのTiUPまたはTiDB Operatorを使用してクラスターをアップグレードした場合は、手順FAQ参照してください。

Top SQLは、有効化するとクラスターのパフォーマンスにわずかな影響（平均3%以内）を与えるため、デフォルトでは有効化されていません。Top Top SQLは、以下の手順で有効化できます。

Top SQLページご覧ください。
「設定を開く」をクリックします。設定領域の右側にある「機能を有効にする」をオンにします。
[保存]をクリックします。

この機能を有効にした後、 Top SQLがデータをロードするまで最大1分ほどお待ちください。その後、CPU負荷の詳細を確認できます。

UI に加えて、TiDB システム変数tidb_enable_top_sql設定することでTop SQL機能を有効にすることもできます。

SET GLOBAL tidb_enable_top_sql = 1;

Top SQLを使用する

Top SQLを使用する一般的な手順は次のとおりです。

Top SQLページご覧ください。
負荷を監視する特定の TiDB または TiKV インスタンスを選択します。
どのTiDBまたはTiKVインスタンスを監視すべきかわからない場合は、任意のインスタンスを選択できます。また、クラスターのCPU負荷が極端に不均衡な場合は、まずGrafanaチャートを使用して、監視するインスタンスを特定することもできます。
Top SQLが提示するグラフと表を観察します。
棒グラフの棒の大きさは、その時点でSQL文が消費しているCPUリソースの量を表しています。色の違いはSQL文の種類によって区別されます。ほとんどの場合、グラフ内の対応する時間範囲においてCPUリソースのオーバーヘッドが大きいSQL文にのみ注目すれば十分です。
表内のSQL文をクリックすると、詳細情報が表示されます。その文の様々なプランにおける詳細な実行指標（Call/sec（1秒あたりの平均クエリ数）やScan Indexes/sec（1秒あたりの平均インデックス行スキャン数）など）を確認できます。
これらの最初の手がかりに基づいて、 SQL文目または遅いクエリページ目をさらに調査し、CPU 消費量の増加や SQL ステートメントの大量データスキャンの根本原因を見つけることができます。
タイムピッカーで時間範囲を調整するか、チャートで時間範囲を選択すると、問題をより正確かつ詳細に把握できます。時間範囲を狭くすると、最大1秒単位の精度でより詳細なデータを取得できます。
グラフが古い場合は、 [更新]ボタンをクリックするか、 [更新]ドロップダウンリストから [自動更新] オプションを選択できます。
テーブルまたはデータベースレベルごとにCPUリソースの使用状況をビュー、より高レベルのリソース使用状況を迅速に把握できます。現在、TiKVインスタンスのみがサポートされています。
TiKV インスタンスを選択し、テーブル別またはDB 別を選択します。
集計結果を上位レベルでビュー。