{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_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

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       |                |
+------------+----------+------+-----+---------+----------------+

DESCRIBE 是 SHOW COLUMNS 的简写。这些语句也显示视图的信息。DESCRIBE 语句的描述提供了关于输出列的更多信息。见第15.7.7.6节，“SHOW COLUMNS 语句”。

默认情况下，DESCRIBE 显示表中的所有列信息。col_name，如果给出，是表中的一个列名。在这种情况下，语句只显示该列的信息。wild，如果给出，是一个模式字符串。它可以包含 SQL 的% 和 _ 通配符字符。在这种情况下，语句只显示名称匹配该字符串的列没有必要将字符串括在引号中，除非它包含空格或其他特殊字符。

描述语句是为了与 Oracle 兼容提供的。

SHOW CREATE TABLE、SHOW TABLE STATUS 和 SHOW INDEX 语句也提供了表的信息。见第15.7.7节，“SHOW 语句”。

explain_format 系统变量对 EXPLAIN 语句的输出无效，用于获取表列信息。

EXPLAIN 语句提供了 MySQL 执行语句的信息：

EXPLAIN 需要执行解释语句所需的相同权限。此外，EXPLAIN 还需要SHOW VIEW 权限，以便解释视图。 EXPLAIN ... FOR CONNECTION 还需要PROCESS 权限，如果指定的连接属于不同用户。

系统变量 explain_format 确定了使用EXPLAIN 显示查询执行计划时的输出格式。这个变量可以取所有与FORMAT 选项相同的值，除了DEFAULT 是TRADITIONAL 的同义词。以下示例使用了MySQL: Other Downloads 中的 world 数据库中的 country 表：

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 8.4支持两个JSON输出格式的版本。第1个版本是线性格式，始终在MySQL 8.2和更早期版本中使用；在MySQL 8.4中，这仍然是默认值，并且在本节中的示例中已经显示了。第2个版本的JSON输出格式基于访问路径，旨在为未来MySQL优化器版本提供兼容性。你可以通过将explain_json_format_version服务器系统变量设置为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' <= Code <= 'A????????')"
      ],
      "covering": false,
      "operation": "Index range scan on country using PRIMARY over ('A' <= Code <= '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)

使用Version 2格式后，你可以通过将explain_json_format_version设置回1(默认值），使所有后续的EXPLAIN FORMAT=JSON语句返回到第1个版本的格式。

explain_json_format_version 值确定所有使用该值的 EXPLAIN 语句所用的 JSON 输出格式，是否使用 JSON 格式取决于给定的 EXPLAIN 语句是否包含明确的 FORMAT=JSON 选项，或者是因为系统变量 explain_format 设置为 JSON。

使用EXPLAIN，可以查看需要在哪些表中添加索引以提高语句执行速度。您也可以使用EXPLAIN检查优化器是否按最优顺序连接表。要将 optimizer 提示使用与 SELECT 语句中表名的顺序相符的连接顺序，开始语句以 SELECT STRAIGHT_JOIN 而不是SELECT。 (参见第15.2.13节，“SELECT 语句”。)

优化器跟踪可能会提供与EXPLAIN相同的信息，但是优化器跟踪格式和内容在版本之间可能会发生变化。详细信息请见MySQL Internals: Tracing the Optimizer。

如果您遇到索引不被使用的问题，认为它们应该被使用，请运行ANALYZE TABLE来更新表统计信息，如键的基数，可以影响优化器的选择。见第15.7.3.1节，“ANALYZE TABLE 语句”。

EXPLAIN ANALYZE 执行语句并生成EXPLAIN输出，包括时间和关于优化器期望与实际执行的详细信息。对于每个迭代器，提供以下信息：

查询执行信息使用TREE输出格式，节点表示迭代器。EXPLAIN ANALYZE总是使用TREE输出格式，可以使用FORMAT=TREE来指定；其他格式仍然不支持。

EXPLAIN ANALYZE可以与SELECT语句、多表UPDATE和DELETE语句、TABLE语句一起使用。

您可以使用KILL QUERY或CTRL-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_format 对 EXPLAIN ANALYZE 产生以下影响：

我们在这里重用上一个示例中的最后一个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)

使用 FORMAT=TRADITIONAL 或 FORMAT=JSON 与 EXPLAIN ANALYZE 总是引发错误，不管explain_format 的值是什么。

在 MySQL 8.4 中，EXPLAIN ANALYZE 和 EXPLAIN FORMAT=TREE 输出的数字遵循以下规则：