文件首頁
MySQL 9.0 參考手冊
相關文件 下載本手冊
PDF (美式信紙) - 40.0Mb
PDF (A4) - 40.1Mb
Man Pages (TGZ) - 258.2Kb
Man Pages (Zip) - 365.3Kb
Info (Gzip) - 4.0Mb
Info (Zip) - 4.0Mb


MySQL 9.0 參考手冊  /  ...  /  EXPLAIN 語句

15.8.2 EXPLAIN 語句

{EXPLAIN | DESCRIBE | DESC}
    tbl_name [col_name | wild]

{EXPLAIN | DESCRIBE | DESC}
    [explain_type] [INTO variable]
    {[schema_spec] explainable_stmt | FOR CONNECTION connection_id}

{EXPLAIN | DESCRIBE | DESC} ANALYZE [FORMAT = TREE] [schema_spec] select_statement

{EXPLAIN | DESCRIBE | DESC} ANALYZE FORMAT = JSON INTO variable [schema_spec] select_statement

explain_type: {
    FORMAT = format_name
}

format_name: {
    TRADITIONAL
  | JSON
  | TREE
}

explainable_stmt: {
    SELECT statement
  | TABLE statement
  | DELETE statement
  | INSERT statement
  | REPLACE statement
  | UPDATE statement
}

schema_spec:
FOR {SCHEMA | DATABASE} schema_name

DESCRIBEEXPLAIN 語句是同義詞。實際上,DESCRIBE 關鍵字更常用於取得關於表格結構的資訊,而 EXPLAIN 則是用於取得查詢執行計畫(也就是 MySQL 將如何執行查詢的說明)。

以下討論將根據這些用途使用 DESCRIBEEXPLAIN 關鍵字,但 MySQL 解析器將它們視為完全同義。

取得表格結構資訊

DESCRIBE 提供關於表格中欄位的資訊

mysql> DESCRIBE City;
+------------+----------+------+-----+---------+----------------+
| Field      | Type     | Null | Key | Default | Extra          |
+------------+----------+------+-----+---------+----------------+
| Id         | int(11)  | NO   | PRI | NULL    | auto_increment |
| Name       | char(35) | NO   |     |         |                |
| Country    | char(3)  | NO   | UNI |         |                |
| District   | char(20) | YES  | MUL |         |                |
| Population | int(11)  | NO   |     | 0       |                |
+------------+----------+------+-----+---------+----------------+

DESCRIBESHOW COLUMNS 的快捷方式。這些語句也顯示視圖的資訊。SHOW COLUMNS 的說明提供關於輸出欄位的更多資訊。請參閱 第 15.7.7.6 節,「SHOW COLUMNS 語句」

依預設,DESCRIBE 會顯示關於表格中所有欄位的資訊。如果給定 col_name,則它是表格中欄位的名稱。在這種情況下,語句只顯示已命名欄位的資訊。如果給定 wild,則它是模式字串。它可以包含 SQL %_ 萬用字元。在這種情況下,語句只顯示名稱與字串相符的欄位的輸出。除非字串包含空格或其他特殊字元,否則不需要將字串括在引號內。

提供 DESCRIBE 語句是為了與 Oracle 相容。

SHOW CREATE TABLESHOW TABLE STATUSSHOW INDEX 語句也提供關於表格的資訊。請參閱 第 15.7.7 節,「SHOW 語句」

explain_format 系統變數在使用 EXPLAIN 取得關於表格欄位的資訊時,對其輸出沒有影響。

取得執行計畫資訊

EXPLAIN 語句提供關於 MySQL 如何執行語句的資訊

  • EXPLAIN 可與 SELECTDELETEINSERTREPLACEUPDATETABLE 語句搭配使用。

  • EXPLAIN 與可說明語句搭配使用時,MySQL 會顯示來自最佳化工具關於語句執行計畫的資訊。也就是說,MySQL 會說明它將如何處理語句,包括關於表格如何聯結以及以何種順序聯結的資訊。關於使用 EXPLAIN 來取得執行計畫資訊,請參閱 第 10.8.2 節,「EXPLAIN 輸出格式」

  • EXPLAINFOR CONNECTION connection_id 而不是可說明語句搭配使用時,它會顯示在已命名連線中執行之語句的執行計畫。請參閱 第 10.8.4 節,「取得已命名連線的執行計畫資訊」

  • 對於可說明語句,EXPLAIN 會產生可使用 SHOW WARNINGS 顯示的其他執行計畫資訊。請參閱 第 10.8.3 節,「擴充的 EXPLAIN 輸出格式」

  • EXPLAIN 對於檢查涉及分割表格的查詢很有用。請參閱 第 26.3.5 節,「取得關於分割區的資訊」

  • FORMAT 選項可用於選擇輸出格式。TRADITIONAL 以表格格式呈現輸出。如果沒有 FORMAT 選項,這是預設值。JSON 格式以 JSON 格式顯示資訊。TREE 提供樹狀輸出,其對查詢處理的描述比 TRADITIONAL 格式更精確;它是唯一顯示雜湊聯結使用情況的格式 (請參閱 第 10.2.1.4 節,「雜湊聯結最佳化」),且一律用於 EXPLAIN ANALYZE

    在 MySQL 9.0 中,EXPLAIN 使用的預設輸出格式(也就是說,當它沒有 FORMAT 選項時)由 explain_format 系統變數的值決定。此變數的確切影響稍後將在本節中說明。

    MySQL 9.0 支援 EXPLAIN FORMAT=JSON 的額外 INTO 選項,該選項可將 JSON 格式的輸出儲存到使用者變數中,如下所示

    mysql> EXPLAIN FORMAT=JSON INTO @myselect 
        ->     SELECT name FROM a WHERE id = 2;
    Query OK, 0 rows affected (0.00 sec)
    
    mysql> SELECT @myselect\G
    *************************** 1. row ***************************
    @myex: {
      "query_block": {
        "select_id": 1,
        "cost_info": {
          "query_cost": "1.00"
        },
        "table": {
          "table_name": "a",
          "access_type": "const",
          "possible_keys": [
            "PRIMARY"
          ],
          "key": "PRIMARY",
          "used_key_parts": [
            "id"
          ],
          "key_length": "4",
          "ref": [
            "const"
          ],
          "rows_examined_per_scan": 1,
          "rows_produced_per_join": 1,
          "filtered": "100.00",
          "cost_info": {
            "read_cost": "0.00",
            "eval_cost": "0.10",
            "prefix_cost": "0.00",
            "data_read_per_join": "408"
          },
          "used_columns": [
            "id",
            "name"
          ]
        }
      }
    }
    1 row in set (0.00 sec)

    這適用於任何可說明語句 (SELECTTABLEINSERTUPDATEREPLACEDELETE)。此處顯示使用 UPDATEDELETE 語句的範例

    mysql> EXPLAIN FORMAT=JSON INTO @myupdate 
        ->   UPDATE a SET name2 = "garcia" WHERE id = 3;              
    Query OK, 0 rows affected (0.00 sec)
    
    mysql> EXPLAIN FORMAT=JSON INTO @mydelete 
        ->     DELETE FROM a WHERE name1 LIKE '%e%';
    Query OK, 0 rows affected (0.00 sec)
    
    mysql> SELECT @myupdate, @mydelete\G
    *************************** 1. row ***************************
    @myupdate: {
      "query_block": {
        "select_id": 1,
        "table": {
          "update": true,
          "table_name": "a",
          "access_type": "range",
          "possible_keys": [
            "PRIMARY"
          ],
          "key": "PRIMARY",
          "used_key_parts": [
            "id"
          ],
          "key_length": "4",
          "ref": [
            "const"
          ],
          "rows_examined_per_scan": 1,
          "filtered": "100.00",
          "attached_condition": "(`db`.`a`.`id` = 3)"
        }
      }
    }
    @mydelete: {
      "query_block": {
        "select_id": 1,
        "table": {
          "delete": true,
          "table_name": "a",
          "access_type": "ALL",
          "rows_examined_per_scan": 2,
          "filtered": "100.00",
          "attached_condition": "(`db`.`a`.`name1` like '%e%')"
        }
      }
    }
    1 row in set (0.00 sec)

    您可以使用 MySQL JSON 函式來處理此值,就像處理任何其他 JSON 值一樣,如以下使用 JSON_EXTRACT() 的範例所示

    mysql> SELECT JSON_EXTRACT(@myselect, "$.query_block.table.key");
    +----------------------------------------------------+
    | JSON_EXTRACT(@myselect, "$.query_block.table.key") |
    +----------------------------------------------------+
    | "PRIMARY"                                          |
    +----------------------------------------------------+
    1 row in set (0.01 sec)
    
    mysql> SELECT JSON_EXTRACT(@myupdate, "$.query_block.table.access_type") AS U_acc,
        ->        JSON_EXTRACT(@mydelete, "$.query_block.table.access_type") AS D_acc;
    +---------+-------+
    | U_acc   | D_acc |
    +---------+-------+
    | "range" | "ALL" |
    +---------+-------+
    1 row in set (0.00 sec)

    另請參閱 第 14.17 節,「JSON 函式」

    嘗試在未明確包含 FORMAT=JSON 的情況下使用 INTO 子句會導致 EXPLAINER_EXPLAIN_INTO_IMPLICIT_FORMAT_NOT_SUPPORTED 而遭到拒絕。無論 explain_format 系統變數的目前值為何,都是如此。

    INTO 子句不支援 EXPLAIN ANALYZE;它也不支援 FOR CONNECTION

    重要事項

    如果由於任何原因而拒絕要分析的語句,則不會更新使用者變數。

  • MySQL 9.0 支援 FOR SCHEMA 子句,該子句會導致 EXPLAIN 的行為如同要分析的語句已在已命名資料庫中執行;支援 FOR DATABASE 作為同義詞。此處顯示一個簡單的使用範例

    mysql> USE b;
    Database changed
    mysql> CREATE SCHEMA s1;
    Query OK, 1 row affected (0.01 sec)
    
    mysql> CREATE SCHEMA s2;
    Query OK, 1 row affected (0.01 sec)
    
    mysql> USE s1;
    Database changed
    mysql> CREATE TABLE t (c1 INT NOT NULL AUTO_INCREMENT PRIMARY KEY, c2 INT NOT NULL);
    Query OK, 0 rows affected (0.04 sec)
    
    mysql> USE s2;
    Database changed
    mysql> CREATE TABLE t (c1 INT NOT NULL AUTO_INCREMENT PRIMARY KEY, c2 INT NOT NULL, KEY i1 (c2));
    Query OK, 0 rows affected (0.04 sec)
    
    mysql> USE b;
    Database changed
    mysql> EXPLAIN FORMAT=TREE FOR SCHEMA s1 SELECT * FROM t WHERE c2 > 50\G
    *************************** 1. row ***************************
    EXPLAIN: -> Filter: (t.c2 > 50)  (cost=0.35 rows=1)
        -> Table scan on t  (cost=0.35 rows=1)
    
    1 row in set (0.00 sec)
    
    mysql> EXPLAIN FORMAT=TREE FOR SCHEMA s2 SELECT * FROM t WHERE c2 > 50\G
    *************************** 1. row ***************************
    EXPLAIN: -> Filter: (t.c2 > 50)  (cost=0.35 rows=1)
        -> Covering index scan on t using i1  (cost=0.35 rows=1)
    
    1 row in set (0.00 sec)

    如果資料庫不存在,則語句會因 ER_BAD_DB_ERROR 而遭到拒絕。如果使用者沒有執行語句的必要權限,則會因 ER_DBACCESS_DENIED_ERROR 而遭到拒絕。

    FOR SCHEMAFOR CONNECTION 不相容。

EXPLAIN 需要與執行已說明語句相同的權限。此外,EXPLAIN 還需要任何已說明視圖的 SHOW VIEW 權限。如果指定的連線屬於不同的使用者,則 EXPLAIN ... FOR CONNECTION 也需要 PROCESS 權限。

explain_format 系統變數決定 EXPLAIN 在用於顯示查詢執行計畫時的輸出格式。此變數可以採用與 FORMAT 選項搭配使用的任何值,並將 DEFAULT 作為 TRADITIONAL 的同義詞。以下範例使用來自 world 資料庫的 country 表格,該表格可以從 MySQL:其他下載 取得

mysql> USE world; # Make world the current database
Database changed

檢查 explain_format 的值,我們看到它具有預設值,因此 EXPLAIN (沒有 FORMAT 選項) 會使用傳統的表格輸出

mysql> SELECT @@explain_format;
+------------------+
| @@explain_format |
+------------------+
| TRADITIONAL      |
+------------------+
1 row in set (0.00 sec)

mysql> EXPLAIN SELECT Name FROM country WHERE Code Like 'A%';
+----+-------------+---------+------------+-------+---------------+---------+---------+------+------+----------+-------------+
| id | select_type | table   | partitions | type  | possible_keys | key     | key_len | ref  | rows | filtered | Extra       |
+----+-------------+---------+------------+-------+---------------+---------+---------+------+------+----------+-------------+
|  1 | SIMPLE      | country | NULL       | range | PRIMARY       | PRIMARY | 12      | NULL |   17 |   100.00 | Using where |
+----+-------------+---------+------------+-------+---------------+---------+---------+------+------+----------+-------------+
1 row in set, 1 warning (0.00 sec)

如果我們將 explain_format 的值設定為 TREE,然後重新執行相同的 EXPLAIN 語句,則輸出會使用樹狀格式

mysql> SET @@explain_format=TREE;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@explain_format;
+------------------+
| @@explain_format |
+------------------+
| TREE             |
+------------------+
1 row in set (0.00 sec)

mysql> EXPLAIN SELECT Name FROM country WHERE Code LIKE 'A%';
+--------------------------------------------------------------------------------------------------------------+
| EXPLAIN                                                                                                      |
+--------------------------------------------------------------------------------------------------------------+
| -> Filter: (country.`Code` like 'A%')  (cost=3.67 rows=17)
    -> Index range scan on country using PRIMARY over ('A' <= Code <= 'A????????')  (cost=3.67 rows=17)  |
+--------------------------------------------------------------------------------------------------------------+
1 row in set, 1 warning (0.00 sec)

如先前所述,FORMAT 選項會覆寫此設定。使用 FORMAT=JSON 而不是 FORMAT=TREE 來執行相同的 EXPLAIN 語句,顯示情況確實如此

mysql> EXPLAIN FORMAT=JSON SELECT Name FROM country WHERE Code LIKE 'A%';
+------------------------------------------------------------------------------+
| EXPLAIN                                                                      |
+------------------------------------------------------------------------------+
| {
  "query_block": {
    "select_id": 1,
    "cost_info": {
      "query_cost": "3.67"
    },
    "table": {
      "table_name": "country",
      "access_type": "range",
      "possible_keys": [
        "PRIMARY"
      ],
      "key": "PRIMARY",
      "used_key_parts": [
        "Code"
      ],
      "key_length": "12",
      "rows_examined_per_scan": 17,
      "rows_produced_per_join": 17,
      "filtered": "100.00",
      "cost_info": {
        "read_cost": "1.97",
        "eval_cost": "1.70",
        "prefix_cost": "3.67",
        "data_read_per_join": "16K"
      },
      "used_columns": [
        "Code",
        "Name"
      ],
      "attached_condition": "(`world`.`country`.`Code` like 'A%')"
    }
  }
}                                                                              |
+------------------------------------------------------------------------------+
1 row in set, 1 warning (0.00 sec)

若要將 EXPLAIN 的預設輸出還原為表格格式,請將 explain_format 設定為 TRADITIONAL。或者,您可以將其設定為 DEFAULT,其效果相同,如下所示

mysql> SET @@explain_format=DEFAULT;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@explain_format;
+------------------+
| @@explain_format |
+------------------+
| TRADITIONAL      |
+------------------+
1 row in set (0.00 sec)

MySQL 9.0 支援兩個版本的 JSON 輸出格式。版本 1 是 MySQL 8.2 和更早版本中一律使用的線性格式;這在 MySQL 9.0 中仍然是預設值,並在本節已顯示的範例中使用。JSON 輸出格式的版本 2 是以存取路徑為基礎,旨在與未來版本的 MySQL 最佳化工具相容。您可以將 explain_json_format_version 伺服器系統變數的值設定為 2 來切換至版本 2 格式,如下所示,與先前範例中使用的相同 EXPLAIN 語句

mysql> SELECT @@explain_json_format_version;
+-------------------------------+
| @@explain_json_format_version |
+-------------------------------+
|                             1 |
+-------------------------------+
1 row in set (0.00 sec)

mysql> SET @@explain_json_format_version = 2;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@explain_json_format_version;
+-------------------------------+
| @@explain_json_format_version |
+-------------------------------+
|                             2 |
+-------------------------------+
1 row in set (0.00 sec)

mysql> EXPLAIN FORMAT=JSON SELECT Name FROM country WHERE Code LIKE 'A%';
+------------------------------------------------------------------------------+
| EXPLAIN                                                                      |
+------------------------------------------------------------------------------+
| {
  "query": "/* select#1 */ select `world`.`country`.`Name` AS `Name` from `world`.`country` where (`world`.`country`.`Code` like 'A%')",
  "inputs": [
    {
      "ranges": [
        "('A' &lt;= Code &lt;= 'A????????')"
      ],
      "covering": false,
      "operation": "Index range scan on country using PRIMARY over ('A' &lt;= Code &lt;= 'A????????')",
      "index_name": "PRIMARY",
      "table_name": "country",
      "access_type": "index",
      "estimated_rows": 17.0,
      "index_access_type": "index_range_scan",
      "estimated_total_cost": 3.668778400708174
    }
  ],
  "condition": "(country.`Code` like 'A%')",
  "operation": "Filter: (country.`Code` like 'A%')",
  "access_type": "filter",
  "estimated_rows": 17.0,
  "estimated_total_cost": 3.668778400708174
}                                                                              |
+------------------------------------------------------------------------------+
1 row in set, 1 warning (0.00 sec)

設定 explain_json_format_version = 2 也會啟用對具有 EXPLAIN ANALYZE FORMAT=JSONINTO 子句的支援,這可讓您將 JSON 輸出儲存在使用者變數中,如下所示

mysql> EXPLAIN FORMAT=JSON INTO @v1 SELECT Name FROM country WHERE Code LIKE 'A%';
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @v1\G 
*************************** 1. row ***************************
@v1: {
  "query": "/* select#1 */ select `world`.`country`.`Name` AS `Name` from `world`.`country` where (`world`.`country`.`Code` like 'A%')",
  "inputs": [
    {
      "ranges": [
        "('A' &lt;= Code &lt;= 'A????????')"
      ],
      "covering": false,
      "operation": "Index range scan on country using PRIMARY over ('A' &lt;= Code &lt;= 'A????????')",
      "index_name": "PRIMARY",
      "table_name": "country",
      "access_type": "index",
      "estimated_rows": 17.0,
      "index_access_type": "index_range_scan",
      "estimated_total_cost": 3.668778400708174
    }
  ],
  "condition": "(country.`Code` like 'A%')",
  "operation": "Filter: (country.`Code` like 'A%')",
  "access_type": "filter",
  "estimated_rows": 17.0,
  "estimated_total_cost": 3.668778400708174
}                                                                              |
+------------------------------------------------------------------------------+
1 row in set, 1 warning (0.00 sec)

您可以將變數作為 JSON 函式的引數,以從值中取得特定的資訊項目,如下所示:

mysql> SELECT JSON_EXTRACT(@v1,'$.index_name') AS iname,
    ->        JSON_EXTRACT(@v1, '$.table_name') AS tname\G
*************************** 1. row ***************************
iname: "PRIMARY"
tname: "country"
1 row in set (0.00 sec)

這種形式的 EXPLAIN ANALYZE 需要明確的 FORMAT=JSON 子句,且僅支援 SELECT 陳述式。也支援選擇性的 FOR SCHEMA 選項,但並非必要。(也可以改用 FOR DATABASE)。僅當 explain_json_format_version 等於 2 時,INTO 子句才支援 FORMAT=JSON;否則,陳述式會因錯誤訊息 EXPLAIN ANALYZE does not support FORMAT=JSON with explain_json_format_version=1 而失敗。

在使用 Version 2 格式後,您可以將 explain_json_format_version 設定回 1(預設值),以使所有後續的 EXPLAIN FORMAT=JSON 陳述式產生的 JSON 輸出還原為 Version 1 格式。

explain_json_format_version 的值決定了所有使用它的 EXPLAIN 陳述式所採用的 JSON 輸出格式版本,無論是因為給定的 EXPLAIN 陳述式包含明確的 FORMAT=JSON 選項而使用 JSON 格式,或是因為 explain_format 系統變數設定為 JSON 而自動使用 JSON 格式。

藉助 EXPLAIN,您可以查看應該在哪裡為資料表新增索引,以便透過使用索引來查找資料列,使陳述式執行得更快。您也可以使用 EXPLAIN 來檢查最佳化工具是否以最佳順序聯結資料表。為了提示最佳化工具使用與 SELECT 陳述式中資料表名稱的順序相對應的聯結順序,請以 SELECT STRAIGHT_JOIN 而非僅 SELECT 開始陳述式。(請參閱第 15.2.13 節,「SELECT 陳述式」。)

最佳化工具追蹤有時可能會提供與 EXPLAIN 互補的資訊。但是,最佳化工具追蹤的格式和內容可能會在不同版本之間變更。如需詳細資訊,請參閱MySQL 內部:追蹤最佳化工具

如果您遇到索引在您認為應該使用時卻未使用的問題,請執行 ANALYZE TABLE 來更新資料表統計資料,例如索引鍵的基數,這可能會影響最佳化工具所做的選擇。請參閱第 15.7.3.1 節,「ANALYZE TABLE 陳述式」

注意

MySQL Workbench 具有視覺化 EXPLAIN 功能,可提供 EXPLAIN 輸出的視覺化表示。請參閱教學課程:使用 EXPLAIN 來改善查詢效能

使用 EXPLAIN ANALYZE 取得資訊

EXPLAIN ANALYZE 會執行陳述式,並產生 EXPLAIN 輸出,以及關於最佳化工具的預期與實際執行如何匹配的計時和額外的基於迭代器的資訊。對於每個迭代器,會提供以下資訊:

  • 預估執行成本

    (某些迭代器未由成本模型計算,因此不包含在預估中。)

  • 預估傳回的資料列數

  • 傳回第一列的時間

  • 執行此迭代器(包括子迭代器,但不包括父迭代器)所花費的時間,以毫秒為單位。

    (當有多個迴圈時,此數字會顯示每個迴圈的平均時間。)

  • 迭代器傳回的資料列數

  • 迴圈數

查詢執行資訊會使用 TREE 輸出格式顯示,其中節點代表迭代器。EXPLAIN ANALYZE 一律使用 TREE 輸出格式。這可以使用 FORMAT=TREE 選項明確指定;不支援 TREE 以外的格式。

EXPLAIN ANALYZE 可以與 SELECT 陳述式、多資料表 UPDATEDELETE 陳述式,以及 TABLE 陳述式一起使用。

您可以使用 KILL QUERYCTRL-C 來終止此陳述式。

EXPLAIN ANALYZE 無法與 FOR CONNECTION 一起使用。

範例輸出

mysql> EXPLAIN ANALYZE SELECT * FROM t1 JOIN t2 ON (t1.c1 = t2.c2)\G
*************************** 1. row ***************************
EXPLAIN: -> Inner hash join (t2.c2 = t1.c1)  (cost=4.70 rows=6)
(actual time=0.032..0.035 rows=6 loops=1)
    -> Table scan on t2  (cost=0.06 rows=6)
(actual time=0.003..0.005 rows=6 loops=1)
    -> Hash
        -> Table scan on t1  (cost=0.85 rows=6)
(actual time=0.018..0.022 rows=6 loops=1)

mysql> EXPLAIN ANALYZE SELECT * FROM t3 WHERE i > 8\G
*************************** 1. row ***************************
EXPLAIN: -> Filter: (t3.i > 8)  (cost=1.75 rows=5)
(actual time=0.019..0.021 rows=6 loops=1)
    -> Table scan on t3  (cost=1.75 rows=15)
(actual time=0.017..0.019 rows=15 loops=1)

mysql> EXPLAIN ANALYZE SELECT * FROM t3 WHERE pk > 17\G
*************************** 1. row ***************************
EXPLAIN: -> Filter: (t3.pk > 17)  (cost=1.26 rows=5)
(actual time=0.013..0.016 rows=5 loops=1)
    -> Index range scan on t3 using PRIMARY  (cost=1.26 rows=5)
(actual time=0.012..0.014 rows=5 loops=1)

範例輸出中使用的資料表是由此處顯示的陳述式所建立

CREATE TABLE t1 (
    c1 INTEGER DEFAULT NULL,
    c2 INTEGER DEFAULT NULL
);

CREATE TABLE t2 (
    c1 INTEGER DEFAULT NULL,
    c2 INTEGER DEFAULT NULL
);

CREATE TABLE t3 (
    pk INTEGER NOT NULL PRIMARY KEY,
    i INTEGER DEFAULT NULL
);

此陳述式輸出中的 actual time 顯示的值以毫秒為單位表示。

explain_formatEXPLAIN ANALYZE 具有以下影響:

  • 如果此變數的值為 TRADITIONALTREE(或同義詞 DEFAULT),則 EXPLAIN ANALYZE 會使用 TREE 格式。這確保此陳述式預設會繼續使用 TREE 格式,如同引入 explain_format 之前一樣。

  • 如果 explain_format 的值為 JSON,則 EXPLAIN ANALYZE 會傳回錯誤,除非將 FORMAT=TREE 指定為陳述式的一部分。這是因為 EXPLAIN ANALYZE 僅支援 TREE 輸出格式。

我們在此處說明第二點中所述的行為,重新使用前一個範例中的最後一個 EXPLAIN ANALYZE 陳述式

mysql> SET @@explain_format=JSON;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT @@explain_format;
+------------------+
| @@explain_format |
+------------------+
| JSON             |
+------------------+
1 row in set (0.00 sec)

mysql> EXPLAIN ANALYZE SELECT * FROM t3 WHERE pk > 17\G
ERROR 1235 (42000): This version of MySQL doesn't yet support 'EXPLAIN ANALYZE with JSON format'

mysql> EXPLAIN ANALYZE FORMAT=TRADITIONAL SELECT * FROM t3 WHERE pk > 17\G
ERROR 1235 (42000): This version of MySQL doesn't yet support 'EXPLAIN ANALYZE with TRADITIONAL format'

mysql> EXPLAIN ANALYZE FORMAT=TREE SELECT * FROM t3 WHERE pk > 17\G
*************************** 1. row ***************************
EXPLAIN: -> Filter: (t3.pk > 17)  (cost=1.26 rows=5)
(actual time=0.013..0.016 rows=5 loops=1)
    -> Index range scan on t3 using PRIMARY  (cost=1.26 rows=5)
(actual time=0.012..0.014 rows=5 loops=1)

無論 explain_format 的值為何,將 FORMAT=TRADITIONALFORMAT=JSONEXPLAIN ANALYZE 一起使用總是會引發錯誤。

在 MySQL 9.0 中,EXPLAIN ANALYZEEXPLAIN FORMAT=TREE 的輸出中的數字會根據下列規則格式化:

  • 範圍在 0.001-999999.5 之間的數字會印為十進位數字。

    小於 1000 的十進位數字有三個有效位數;其餘的則有四個、五個或六個。

  • 範圍在 0.001-999999.5 之外的數字會以工程格式印出。這類值的範例包括 1.23e+9934e-6

  • 不會印出尾隨的零。例如,我們會印出 2.3 而不是 2.30,並印出 1.2e+6 而不是 1.20e+6

  • 小於 1e-12 的數字會印為 0