// 免費工具

查詢計畫檢視器

從 SQL Server、PostgreSQL、MySQL、MariaDB、SQLite、DuckDB、ClickHouse 或 Oracle 貼上執行計畫,看看哪裡慢、為什麼慢、該改什麼 - 依優先順序排列的診斷結果、運算子樹和計畫圖。這是 SQLly 桌面應用程式裡的計畫閱讀器,編譯成 WebAssembly,所以在你的瀏覽器中執行,而且 你的執行計畫永遠不會離開你的裝置.

Loading the plan reader…

提示:按下 Ctrl+Enter 鍵 (⌘+Enter 鍵 在 Mac 上)貼進方框中分析。檔案會由你瀏覽器的檔案讀取器在此裝置上讀取;不會上傳任何內容。

這個執行計畫檢視器的功能

查詢計畫是資料庫對「你打算怎麼執行這句?」的回答——它讀哪些索引、怎麼聯結、每一步預期多少資料列、成本花在哪裡。計畫內容很密,每個引擎的寫法又不同。這個檢視器把它們全部讀成同一種模型,並把重點放在最前面:用白話列出排序過的問題清單,每個問題都附上造成影響的原因和具體的下一步。

  • 發現項目優先。 完整掃描、缺少索引、隱含轉換、索引鍵查閱、溢寫、缺少統計資料、交叉聯結、資料列目標與資料列估計失誤——最嚴重的排最前,並標出所屬的運算子;至於 SQL Server 的缺少索引建議,還附上可直接審核的 CREATE INDEX 陳述式。
  • 八個引擎,同一個檢視。 SQL Server、PostgreSQL、MySQL、MariaDB、SQLite、DuckDB、ClickHouse 和 Oracle 的執行計畫讀取方式相同,所以你不需要為每個資料庫使用不同的工具。
  • 樹狀與圖表。 運算子樹並排顯示每個步驟的成本占比、估計列數和實際列數,對於十倍或以上的誤差會特別標出。圖表以自上而下的方式展示計畫,並附有可以一眼掃視的成本條。
  • 批次與貼上的輸出。 多語句的 SQL Server 執行計畫會附帶語句切換器。從 psql、mysql 用戶端或 sqlplus 複製的輸出會自動幫你拆開——不必再手動去除邊框或 + 續行項目排前面。
  • 私人。 整個分析都在你的分頁裡執行。執行計畫會包含你的 SQL、資料表名稱,有時還有參數值;這些都不會被上傳。

如何從每個資料庫取得執行計畫

每個引擎都有兩種類型的計畫。一個 預估 計畫是最佳化器的預測,不會真正執行陳述式。而 實際 實際計畫會執行陳述式並記錄真實列數——這是唯一能看出最佳化器哪裡猜錯的方法。實際擷取也會執行插入、更新和刪除,因此測試資料的變更會包在你隨後復原的交易裡。

SQL Server 和 Azure SQL:ShowPlan XML

實際計畫——執行查詢,並在結果之後針對每個陳述式傳回一份計畫文件:

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。已經在快取或查詢存放區裡的計畫也可以: sys.dm_exec_query_plan(plan_handle) 傳回 XML,並且 sys.query_store_plan.query_plan 會以文字形式保存。如果你從 SSMS 結果網格複製大型執行計畫,而檢視器回報 XML 不完整,那是網格把它截斷了(其 XML 上限設定於 Tools > Options > Query Results > SQL Server > Results to Grid);請改將計畫另存為檔案。

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 版本也可能輸出第二種 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 shell 的樹狀結構(QUERY PLAN, |--, `--)會照原樣讀取,原始的也一樣 id | parent | notused | detail 其他工具傳回的資料列。在 shell 中, .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 ... ;

貼上 JSON,來源為 explain_value 欄位。DuckDB 沒有成本單位,因此實際執行計畫會依運算子的耗時深淺著色。

ClickHouse: EXPLAIN json = 1

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

indexes = 1 會加上每個主鍵、分區鍵和跳過索引各保留了多少部分與顆粒;檢視器就是靠這個找出完全沒有修剪任何東西的讀取。 FORMAT TSVRaw 傳回未轉義的 JSON。ClickHouse 沒有 EXPLAIN ANALYZE,所以它的執行計畫永遠是估計出來的。

Oracle Database: 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 關閉,否則它顯示的「最後一個游標」會是輸出呼叫而不是你的查詢;並加寬 LINESIZE 這樣計畫表格才不會換行。

每個檢查結果代表什麼,以及如何修正

發現項目先依嚴重性排序,再依運算子佔整個陳述式成本的比例排序,因此第一張卡片通常就是你能修正的最昂貴問題。每張卡片都會註明它來自哪個運算子——選取即可跳到樹狀圖中的該位置。

缺少索引

這代表什麼。 編譯陳述式時,SQL Server 找出了一個能降低成本的索引,並在執行計畫中記錄下來,附上預估的改善幅度。檢視器會在讀取該資料表的運算子上回報一次,並把它轉換為 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 倍。後續的每個選擇——JOIN 類型、JOIN 順序、記憶體授與——都是依據錯誤的資料量做出的,因此計畫較下層的大幅誤差,常能解釋其上層計畫為何緩慢。只有當計畫帶有執行階段統計資料時才會出現這項發現。在 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 透過非叢集索引找到資料列,再針對索引未涵蓋的欄位,逐列回到資料表查詢(Key Lookup,或堆積上的 RID Lookup)。查幾列很便宜,幾千列就很貴,因為每一次查閱都是一次獨立的讀取。

如何修正。 如果要處理很多資料列,請將缺少的欄位新增到索引的 INCLUDE 清單,讓它涵蓋整個查詢,或者少選幾個欄位。只有幾列時通常無妨 - 執行計畫會把它標為資訊,而不是警告。

溢出到 tempdb

這代表什麼。 排序或雜湊運算子用光了 SQL Server 核給查詢的記憶體,把中間資料列寫進 tempdb,比在記憶體裡作業慢得多。通常是資料列數估計偏低:核發的記憶體是照比實際到達更少的資料列數估的。

如何修正。 先修正估算(見「資料列估算失準」),用更有選擇性的篩選器減少抵達該運算子的資料列,或捨棄不必要的 ORDER BY 或 DISTINCT。較新的 SQL Server 版本會在多次執行之間自動調整記憶體授權(記憶體授權回饋); MIN_GRANT_PERCENT 查詢提示就是你手動介入的槓桿。

沒有統計資料的欄位

這代表什麼。 SQL Server 對查詢用來篩選或聯結的欄位沒有統計資料,因此它對這些地方的資料列估計只是猜測。

如何修正。 確保 AUTO_CREATE_STATISTICS 在資料庫層級已開啟,或者要在指定欄位上建立統計資料,就用 CREATE STATISTICS.

沒有聯結述詞

這代表什麼。 JOIN 缺少關聯兩側輸入的條件,一側的每一列都會與另一側的每一列配對:兩個各有 1,000 列的資料表,在任何篩選條件跑之前就會變成一百萬列。這幾乎都是漏寫或拼錯 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 把中間資料列存進工作資料表(Table Spool 或 Index Spool)以便重複使用。這通常是合理的最佳化,但出現 eager index spool 就表示最佳化工具在每次執行時都在建立暫存索引,因為缺少永久的索引。

如何修正。 除非 Spool 佔了成本的大宗,否則不用動它。若是索引 Spool,就把它正在建立的索引建出來——它的 seek 欄位會顯示是哪些欄位。

其他最佳化工具警告

這代表什麼。 引擎記錄、但不屬於上述類別的警告,以引擎自己的用語顯示——例如 SQL Server 的記憶體授與過量警告(查詢保留的記憶體遠多於實際使用,讓同時執行的查詢分不到資源),或可能影響基數估計的型別轉換。

如何修正。 閱讀運算子的詳細資料。過度的記憶體授與通常來自資料列數估計過高或 varchar(max) 排序涉及的欄位;其轉換的修正方式與隱含轉換問題相同。

解讀樹狀結構與圖表

  • 資料向上流動。 根運算子——把資料列傳回給你的那個——位於最上方。它的子運算子提供資料列給它,因此最底部的葉節點是從資料表和索引讀取資料的地方。
  • 成本分攤。 百分比是該運算子的估計子樹成本佔整個陳述式的比例,與 SQL Server、PostgreSQL、MySQL 和 Oracle 回報的數字相同。成本是以最佳化器為單位,不是毫秒,並包含該運算子底下的所有內容;DuckDB 的計畫改用時間表示,SQLite 與 ClickHouse 的計畫則完全沒有成本。
  • 預估 → 實際。 在實際執行計畫中,每個運算子都會顯示最佳化工具預期的數字與實際發生的情況。相差 10 倍以上會醒目提示,因為計畫出錯往往就出在這裡。
  • 琥珀色長條。 在圖中,運算子下方的長條會追蹤其成本占比,當該運算子有警告時會變成琥珀色。

網頁檢視器和 SQLly 桌面應用程式

此頁面及 SQLly 的計畫窗格 共用相同的解析器和分析引擎。桌面應用程式增加了所有需要即時連線的功能。

功能網頁檢視器SQLly 桌面版
發現項目、運算子樹與圖表是是
開啟或貼上已儲存的計畫是是
一個快速鍵就能擷取實際或預估的執行計畫-可以,在編輯器裡
記住每個連線的 EXPLAIN 選項(ANALYZE、BUFFERS、VERBOSE…)-是
僅執行 SELECT 陳述式的設定檔預設集-是
比較同一查詢的兩次擷取結果-是
在新查詢分頁中開啟建議的索引僅複製是
執行計畫的 AI 導覽-是

查詢計畫檢視器常見問題

這個查詢計畫檢視器是免費的嗎?

是的。不用註冊,開幾個執行計畫都沒有限制。它就是把 SQLly 桌面應用程式裡的計畫閱讀器包成免費網頁工具。

我的執行計畫會被上傳出去嗎?

不。檢視器已編譯為 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 沒有成本單位,因此這些計畫顯示的是運算子結構和掃描,而不是成本占比。實際資料列數僅出現在以執行階段統計資料擷取的計畫中。

我可以比較兩個執行計畫嗎?

網頁檢視器沒有這個。 SQLly 桌面應用程式 會保留你在每個查詢分頁擷取的計畫歷史,並比較其中任意兩份,點出哪些運算子退步了、改善了、新出現或消失了。

// 跳過複製貼上

在你撰寫 SQL 的地方擷取、閱讀並比較執行計畫

SQLly 是適用於 macOS、Windows 與 Linux 的原生 SQL 工作台。在編輯器中按 Explain 即可擷取實際或預估的執行計畫,看到與本頁相同的分析發現,並比較兩次執行來證明調校真的有效。