// 無料のツール

クエリプランビューアー

SQL Server、PostgreSQL、MySQL、MariaDB、SQLite、DuckDB、ClickHouse、Oracle の実行プランを貼り付けると、何が遅いのか、なぜ遅いのか、何を変えればよいのかが分かります。優先度順の所見、オペレーターツリー、プランダイアグラムが表示されます。これは SQLly デスクトップアプリのプランリーダーを WebAssembly にコンパイルしたものなので、ブラウザー内で動作し、 実行プランがデバイスを離れることはありません.

Loading the plan reader…

ヒント: 次のキーを押してください Ctrl+Enter (⌘+Enter Mac の場合) 解析用のボックスに入れます。ファイルはブラウザーのファイルリーダーでこのデバイス上で読み取られ、アップロードはされません。

この実行プランビューアーができること

クエリプランは、「これをどう実行するのか」というデータベースからの答えです。どのインデックスを読むか、どう結合するか、各ステップで何行を見込むか、コストがどこにかかるかが示されます。プランは情報が密で、エンジンごとに書き方も異なります。このビューアーは、それらすべてを 1 つのモデルに読み込み、重要な点を先頭に示します。問題を平易な言葉で優先度順に並べたリストで、それぞれに、なぜ問題なのかという理由と、具体的な次の一手が添えられています。

  • まず検出結果から。 フルスキャン、不足しているインデックス、暗黙の型変換、キー検索、スピル、統計の欠落、クロス結合、行ゴール、行数推定のずれを、深刻なものから順に、該当するオペレーターとともに表示します。SQL Server の不足インデックスの提案には、レビューできる状態の CREATE INDEX ステートメント。
  • 8 つのエンジン、1 つのビュー。 SQL Server、PostgreSQL、MySQL、MariaDB、SQLite、DuckDB、ClickHouse、Oracle のプランは同じように読めるため、データベースごとに別のツールは必要ありません。
  • ツリーと図。 オペレーターツリーには、各ステップのコストの割合、推定行数、実際の行数が並べて表示され、10 倍以上のずれはハイライトされます。ダイアグラムは、プランを上から下に配置し、一目で確認できるコストバーを備えています。
  • バッチおよび貼り付けられた出力。 複数ステートメントのSQL Serverプランには、ステートメント切り替えが付きます。psql、mysqlクライアント、sqlplusからコピーした出力は自動的に整形されるので、罫線などを取り除く必要はありません。 + 続きを先に。
  • プライベート。 分析はすべてタブ内で実行されます。プランには SQL、テーブル名、場合によってはパラメータ値が含まれますが、何もアップロードされません。

各データベースから実行計画を取得する方法

すべてのエンジンには 2 種類のプランがあります。 推定 プランはオプティマイザーの予測であり、ステートメントは実行しません。 実際 プランはステートメントを実行して実際の行数を記録します。オプティマイザーの推定がどこで外れたかを確認できる唯一の方法です。実行時キャプチャは INSERT、UPDATE、DELETE も実行します。そのため、テストデータへの変更はロールバックするトランザクション内にとどまります。

SQL ServerとAzure SQL: ShowPlan XML

実際のプラン — クエリを実行し、結果の後にステートメントごとに 1 つのプランドキュメントを返します:

SET STATISTICS XML ON;
SELECT ... ;   -- your query
SET STATISTICS XML OFF;

推定プラン - 実行せずにコンパイルします。 SET SHOWPLAN_XML バッチ内で唯一のステートメントである必要があります。そのため、 GO 区切り文字:

SET SHOWPLAN_XML ON;
GO
SELECT ... ;   -- your query
GO
SET SHOWPLAN_XML OFF;

SSMS で、次をオンにします 実際の実行計画を含める (Ctrl+M)、または次を使用します 推定実行プランを表示 (Ctrl+L)、次にグラフィカルプランを右クリックして、次を選びます: 実行プランに名前を付けて保存… 取得するには .sqlplan ここで開けるファイル、または 実行プラン XML を表示… XML をコピーできます。キャッシュや Query Store にある既存のプランも使えます: sys.dm_exec_query_plan(plan_handle) XML を返し、 sys.query_store_plan.query_plan テキストとして保持します。SSMS の結果グリッドから大きなプランをコピーしてビューアーが不完全な XML と報告する場合は、グリッドが切り詰めています (XML の上限は ツール > オプション > クエリ結果 > SQL Server > グリッドへの結果 で設定)。代わりにプランをファイルとして保存してください。

PostgreSQL: EXPLAIN (FORMAT JSON)

-- Actual plan: runs the query
EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) SELECT ... ;

-- Estimated plan: does not run it
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Measure a data change without keeping it
BEGIN;
EXPLAIN (ANALYZE, FORMAT JSON) UPDATE ... ;
ROLLBACK;

ビューアーが読み取るのは JSON 形式で、PostgreSQL の既定のテキスト出力ではありません。psql からそのまま貼り付けても問題ありません。 QUERY PLAN ヘッダーと + 各行の末尾にあるものが削除されます。または実行します psql -XqAt -c "EXPLAIN (ANALYZE, FORMAT JSON) ..." クリーンな出力のため。アプリケーションが実行したクエリのプランについては、 auto_explain モジュールは、それらを次の設定でログに記録できます auto_explain.log_format = json.

MySQL: EXPLAIN FORMAT=JSON と EXPLAIN ANALYZE

-- Estimated plan as JSON: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan (MySQL 8.0.18 and later): runs the query
EXPLAIN ANALYZE SELECT ... ;

どちらも読み込まれ、ビューアーは形状で区別します。mysql クライアントのテーブル罫線、 \G 行数バナーと「1 row in set」のフッターは、貼り付け時に取り除かれます。新しい MySQL のリリースでは、2 つ目の JSON レイアウトで出力されることもあります(explain_json_format_version = 2)。ビューアーは元のファイルを読み込むため、次を実行してください: SET explain_json_format_version = 1; サーバーのデフォルトがバージョン2の場合は、最初に

MariaDB: EXPLAIN と ANALYZE FORMAT=JSON

-- Estimated plan: does not run the query
EXPLAIN FORMAT=JSON SELECT ... ;

-- Actual plan with r_rows, r_loops and timings: runs the query
ANALYZE FORMAT=JSON SELECT ... ;

SQLite: EXPLAIN QUERY PLAN

EXPLAIN QUERY PLAN SELECT ... ;

SQLite は、次のステートメントを決して実行しません EXPLAIN QUERY PLAN、そのプランにはコストや行数の見積もりはなく、ステップだけです。それでも次を見つけるには十分です: SCAN であるべきもの SEARCH。その sqlite3 シェルのツリー(QUERY PLAN, |--, `--)はそのまま読み取られ、生の id | parent | notused | detail 他のツールが返す行。シェルでは、 .eqp on 実行するすべてのステートメントの前にプランを出力します。

DuckDB: EXPLAIN (FORMAT JSON)

-- Estimated plan
EXPLAIN (FORMAT JSON) SELECT ... ;

-- Actual plan with per-operator rows and timing: runs the query
EXPLAIN (ANALYZE, FORMAT JSON) SELECT ... ;

貼り付け元の explain_value 列。DuckDBにはコスト単位がないため、実際のプランでは、各オペレーターを所要時間に応じて濃淡で表示します。

ClickHouse: EXPLAIN json = 1

EXPLAIN json = 1, indexes = 1
SELECT ...
FORMAT TSVRaw;

indexes = 1 各プライマリキー、パーティションキー、スキップインデックスが保持したパーツ数とグラニュール数を追加します。ビューアーはこれによって、何も絞り込めなかった読み取りを見つけます。 FORMAT TSVRaw エスケープせずに JSON を返します。ClickHouse には EXPLAIN ANALYZE、そのため、そのプランは常に推定値です。

Oracle データベース:DBMS_XPLAN

-- Estimated plan: does not run the query
EXPLAIN PLAN FOR SELECT ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY);

-- Actual plan: run the query with row-source statistics, then read its cursor
SET SERVEROUTPUT OFF
SET LINESIZE 300
SELECT /*+ GATHER_PLAN_STATISTICS */ ... ;
SELECT * FROM TABLE(DBMS_XPLAN.DISPLAY_CURSOR(NULL, NULL, 'ALLSTATS LAST'));

述語情報(Predicate Information)セクションを含む出力全体を貼り付けてください。ビューアーはそれぞれの access そして filter 述語をその操作に結びつけます。 DISPLAY_CURSOR 次への SELECT アクセスが必要です V$SESSION, V$SQL, V$SQL_PLAN そして V$SQL_PLAN_STATISTICS_ALL、ユーザーに直接付与されたもの。次を維持してください SERVEROUTPUT SQL*Plus または SQLcl で off にします。そうしないと、表示される「last cursor」がクエリではなく出力呼び出しのものになります。また、次を広げます LINESIZE そのため、プランの表は折り返されません。

各検出結果の意味と対処方法

検出結果は、重大度順、次にステートメント全体のコストに占める演算子の割合の順に並べられるため、最初のカードは通常、修正できる最もコストの高い問題です。各カードには、その元になった演算子名が表示されます。選択すると、ツリー内のその位置にジャンプします。

インデックスの欠落

意味。 ステートメントのコンパイル中に、SQL Server は、コストを下げられるインデックスを割り出し、推定される改善率とともにプランに記録しました。ビューアーは、そのテーブルを読み取る演算子について 1 回だけそれを報告し、それを次に変換します CREATE NONCLUSTERED INDEX ステートメント。推定影響が 90% 以上の提案は「重大」としてマークされます。

修正方法。 このステートメントは下書きとして扱ってください。オプティマイザは、等価条件の列、次に不等価条件の列、最後にインクルード列の順に列挙しますが、既存のインデックスは確認していません。多くの場合、ほぼ重複するインデックスを追加する代わりに、既存のインデックスを拡張できます。また、インデックスが増えるほど書き込みは遅くなります。キー列の順序が他のクエリにも適しているか確認してから作成し、実行プランをもう一度キャプチャしてください。この検出結果は SQL Server のプランからのみ得られます。他のエンジンはインデックスの提案を記録しません。

テーブルのフルスキャン

意味。 オペレーターは、必要な行を見つけるために、テーブル(またはインデックス全体)のすべての行を読み取ります。ビューアーは、SQL Server のテーブルスキャンと、残余述語を伴うインデックススキャン、PostgreSQL の Seq Scan、MySQL と MariaDB access_type: ALL そして Table scan on、SQLite SCAN インデックスのないステップ、プッシュダウンされたフィルタのない DuckDB のスキャン、インデックスでグラニュールを除外できなかった ClickHouse の読み取り、および Oracle TABLE ACCESS FULL.

修正方法。 スキャンは、小さなテーブルや、行の大半を必要とするクエリには適切な選択です。フィルターの選択性が高い場合は、フィルターまたは結合に使う列にインデックスを追加し、述語がそれを使えるようにしてください。列を関数で包まないこと(WHERE lower(email) = ... (PostgreSQL では式インデックスが必要)、先頭にワイルドカードがないこと、 LIKE '%x'、および一致するデータ型。ClickHouse では、テーブルの ORDER BY キーまたはスキップインデックスを追加します。

行数見積もりの誤差

意味。 実際のプランで、その演算子についてオプティマイザーが見積もった行数の 10 倍以上か 10 分の 1 以下の行が読み込まれました。以降の選択(結合の種類、結合順序、メモリ許可)はすべて、間違ったデータ量を前提に決められているため、プランの下位で起きた大きな見積もり違いが、その上の遅さの原因になっていることがよくあります。この検出結果は、プランにランタイム統計がある場合にのみ表示されます。SQL Server のプランでは演算子の全実行にわたって見積もりが比較され、PostgreSQL ではループごとに両方の数値が報告されます。

修正方法。 統計情報から始める: UPDATE STATISTICS SQL Server では、 ANALYZE PostgreSQL で、 ANALYZE TABLE MySQL と MariaDB の DBMS_STATS.GATHER_TABLE_STATS Oracle で。それでも数値が大きくずれている場合は、述語の見積もりが難しい状態です: 相関のある列 (PostgreSQL の CREATE STATISTICS が役立ちます)、列に対する関数、または T-SQL のローカル変数。オプティマイザーはその値を認識できません (OPTION (RECOMPILE) を付けると可能になります)。

暗黙の型変換によりシークが妨げられる

意味。 SQL Server は比較の前に列の値を別の型に変換する必要があったため、その列のインデックスをシークできず、代わりにスキャンしました。典型的な原因は nvarchar パラメーターとの比較で発生します。対象は varchar 列。ビューアは、SQL Serverの「Seek Plan」変換警告を報告します。カーディナリティの推定にのみ影響する変換は、オプティマイザーの警告として別に一覧表示されます。

修正方法。 比較する値を列の型に合わせます。パラメーターを次のように宣言します varchar、文字列から型を推論させるのではなく、データアクセスコードでパラメータの型と長さを明示的に設定するか、本当に Unicode であるべきならその列を変更します。

キーのルックアップ

意味。 SQL Server は非クラスター化インデックスで行を見つけた後、インデックスに含まれない列を取得するために行ごとにテーブルへ戻りました (キー ルックアップ、またはヒープ上の RID ルックアップ)。数行なら安く済みますが、各ルックアップが個別の読み取りになるため、数千行では高くつきます。

修正方法。 多数の行に対して実行される場合は、インデックスに不足している列を追加します INCLUDE リストを広げてクエリ全体をカバーするか、選択する列を減らしてください。行数が少なければ通常は問題ありません。プランでは、これは警告ではなく情報として表示されます。

Tempdb へのスピル

意味。 ソートまたはハッシュ演算子が、SQL Server がクエリに付与したメモリを使い切り、中間行を tempdb に書き出しました。これはメモリ内で処理するよりはるかに遅くなります。通常は行数の見積もりが低いことの症状で、実際に届いた行数より少ない行数を前提にメモリ許可のサイズが決められています。

修正方法。 まず見積もりを修正し(「行数見積もりのずれ」を参照)、より選択的なフィルターで演算子に到達する行を減らすか、不要な ORDER BY または DISTINCT。新しい SQL Server のバージョンは、実行の合間にメモリ許可を自動的に調整します(メモリ許可フィードバック)。 MIN_GRANT_PERCENT クエリヒントは手動での調整手段です。

統計のない列

意味。 SQL Server には、クエリがフィルターまたは結合に使う列の統計情報がなかったため、その部分の行数見積もりは推測になります。

修正方法。 必ず AUTO_CREATE_STATISTICS がデータベースで有効になっているか、名前を指定した列の統計を次のコマンドで作成します CREATE STATISTICS.

JOIN 条件なし

意味。 JOIN に 2 つの入力を関連付ける条件がないため、一方の側のすべての行が他方の側のすべての行と組み合わされます。1,000 行のテーブル 2 つは、フィルターが実行される前に 100 万行になります。ほとんどの場合、原因は次の ON 句。

修正方法。 結合条件を追加します。本当にすべての組み合わせが必要な場合は、次のように書きます: CROSS JOIN そのため、意図が明確になります。

行の目標

意味。 TOP, EXISTS, IN または OPTION (FAST n) SQL Server に最初の数行だけが必要だと伝えたため、完了まで実行するコストが高くなる場合でも、素早く結果を返し始めるプラン(多くはインデックスに対する入れ子ループ)が選ばれました。

修正方法。 通常は何もする必要はありません。TOP N クエリで望ましいプランです。クエリが想定された目標よりはるかに多くの行を読み込む場合は、行ゴールがそのプランの形になっている原因です。SQL Server 2016 SP1 以降では次を受け付けます OPTION (USE HINT('DISABLE_OPTIMIZER_ROWGOAL')) それがない場合のプランと比較するため。

スプール

意味。 SQL Server は、再利用するために中間行をワークテーブル (テーブルスプールまたはインデックススプール) に保存しました。多くの場合これは妥当な最適化ですが、イーガーインデックススプールは、恒久的なインデックスがないために、オプティマイザーが実行のたびに一時インデックスを作成していることを意味します。

修正方法。 スプールがコストの大部分を占めていない限り、手を付けないでください。インデックススプールの場合は、構築しようとしているインデックスを作成してください。シーク列がそれを示します。

その他のオプティマイザーの警告

意味。 上のどのカテゴリにも当てはまらない、エンジンが記録した警告を、エンジン本来の表現のまま表示します。たとえば、SQL Server の過剰なメモリグラント警告(クエリが使用量をはるかに上回るメモリを確保し、同時実行中のクエリをメモリ不足に陥らせる)や、カーディナリティ推定に影響する可能性のある型変換などです。

修正方法。 オペレーターの詳細を読んでください。過大なメモリグラントは、通常、行数の過大見積もりや幅の広い varchar(max) 並べ替え対象の列。変換は、暗黙の変換の検出結果と同じ方法で修正されます。

ツリーと図の読み方

  • データは上へ流れます。 ルート演算子(行を呼び出し元に返すもの)が最上位にあります。その子演算子がルートに行を渡すため、最下部のリーフでテーブルやインデックスからデータが読み取られます。
  • コスト分担。 パーセンテージは、ステートメント全体に対する、そのオペレーターの推定サブツリーコストで、SQL Server、PostgreSQL、MySQL、Oracle が報告するのと同じ数値です。コストはミリ秒ではなくオプティマイザー単位で、そのオペレーター以下のすべてを含みます。DuckDB のプランは代わりに時間を使用し、SQLite と ClickHouse のプランにはコストがまったくありません。
  • 推定 → 実際。 実際の実行計画では、各演算子について、オプティマイザーの予想と実際の結果が表示されます。10 倍以上の差は、実行計画が狂う原因になりやすいため、強調表示されます。
  • アンバー色のバー。 ダイアグラムでは、オペレーターの下のバーがそのオペレーターのコスト比率を示し、警告があるオペレーターではアンバー色になります。

Web ビューアーと SQLly デスクトップアプリ

このページと SQLly のプランペイン 同じパーサーと検出エンジンを共有します。デスクトップアプリには、ライブ接続が必要な機能がすべて追加されます。

機能Web ビューアーSQLly デスクトップ
検出結果、演算子ツリー、図はいはい
保存されたプランを開くか貼り付けますはいはい
実際のプランまたは推定プランを 1 つのショートカットでキャプチャする-はい、エディタから
EXPLAIN オプション (ANALYZE、BUFFERS、VERBOSE…) は接続ごとに記憶されます-はい
SELECT ステートメントのみを実行するプロファイルプリセット-はい
同じクエリの2つのキャプチャを比較する-はい
提案されたインデックスを新しいクエリタブで開くコピーのみはい
AI による実行プランの解説-はい

クエリプランビューアーFAQ

このクエリプランビューアーは無料で使えますか?

はい。サインアップは不要で、開けるプランの数にも制限はありません。SQLlyデスクトップアプリのプランリーダーを、無料のWebツールとして公開したものです。

実行プランはどこかにアップロードされますか?

いいえ。ビューアーは WebAssembly にコンパイルされ、ブラウザータブ内で実行されます。貼り付けたり開いたりしたプランはお使いのデバイス上で読み込まれ、サーバーに送信されることも、記録や保存されることもありません。プランには SQL テキスト、テーブル名、場合によってはパラメーター値が含まれるため、この点は重要です。

どのプラン形式を読み取れますか?

SQL Server ShowPlan XML(.sqlplan ファイル、 SET STATISTICS XML そして SET SHOWPLAN_XML 出力)、PostgreSQL EXPLAIN (FORMAT JSON) の有無にかかわらず ANALYZE、MySQL EXPLAIN FORMAT=JSON そして EXPLAIN ANALYZE、MariaDB EXPLAIN FORMAT=JSON そして ANALYZE FORMAT=JSON、SQLite EXPLAIN QUERY PLAN、DuckDB EXPLAIN (FORMAT JSON)、ClickHouse EXPLAIN json = 1 およびOracleの DBMS_XPLAN 出力。形式は自動的に検出されます。

実際のプランを取得すると、クエリが実行されますか?

はい。 SET STATISTICS XML, EXPLAIN ANALYZE, ANALYZE FORMAT=JSON そして GATHER_PLAN_STATISTICS いずれもステートメントを実行します。次のものも含めて INSERT, UPDATE または DELETE。推定形式を使用します(SET SHOWPLAN_XML, EXPLAIN なし ANALYZE, EXPLAIN PLAN FOR)。ステートメントを実行させたくないときに使ったり、データ変更を後でロールバックできるトランザクションで包んだりできます。

PostgreSQL のプランを読み取れないのはなぜですか?

ビューアーが読み取るのは、既定のテキスト形式ではなく PostgreSQL の JSON 形式の実行プランです。実行してください EXPLAIN (FORMAT JSON) または EXPLAIN (ANALYZE, FORMAT JSON) 結果を貼り付けます。psqlからそのままコピーした出力(その QUERY PLAN ヘッダーと + 各行の末尾にあるものは、自動的にクリーンアップされます。

一部のエンジンでコストや行数が表示されないのはなぜですか?

ビューアーが表示するのは、エンジンが報告する内容だけです。SQLite の EXPLAIN QUERY PLAN コストや行数の推定値がなく、ClickHouse にはコストモデルがなく、DuckDB にはコスト単位がないため、これらのプランではコストの割合ではなく、演算子の構造とスキャンが表示されます。実際の行数は、実行時統計付きで取得したプランにのみ表示されます。

2 つの実行プランを比較できますか?

Web ビューアーにはありません。 SQLly デスクトップアプリ 各クエリタブで取得したプランの履歴を保持し、任意の 2 つを比較して、悪化した演算子、改善した演算子、新しく現れた演算子、消えた演算子を示します。

// コピペは不要

SQL を書く場所で、プランをキャプチャ、読み取り、比較する

SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。エディターで「Explain」を押して実際のプランまたは推定プランを取得し、このページと同じ検出事項を読み、2 回の実行を比較してチューニングの変更が効いたことを確かめられます。