EXPLAIN

EXPLAIN — 展示一个语句的执行计划。

语法结构

1. EXPLAIN [ ( option [, ...] ) ] statement

3. where option can be one of:
4. ANALYZE [ boolean ]
5. VERBOSE [ boolean ]
6. FORMAT { TEXT | JSON }

语法描述

此命令主要作用是显示出 MatrixOne 计划程序为提供的语句生成的执行计划。执行计划显示了如何通过普通顺序扫描、索引扫描等方式扫描语句引用的表,如果引用了多个表,将使用什么连接算法将每个输入表中所需的行聚集在一起。

显示的最关键部分是估计语句执行成本,即计划程序将估计运行语句所需时间 (以任意一种成本单位衡量,但通常是通过磁盘页获取)。实际上这里显示了两个数字:返回第一行之前的启动成本,以及返回所有行的总成本。对于大多数查询来说,总成本是最重要的,但在 EXISTS 中的子查询中,计划程序会选择最小的启动成本,而不是最小的总成本 (因为执行者在获得一行之后就会停止)。此外,如果您使用 LIMIT 从句限制返回的行数,计划程序将在端点成本之间进行适当的插值,以便估计哪个计划真正是最便宜的。

ANALYZE 子句语法选项为语句实际执行,而不仅仅是计划执行,然后将实际运行时统计信息添加到显示中,包括每个计划节点中花费的总运行时间 (以毫秒为单位) 和实际返回的行总数。这有助于了解规划者的期望是否接近实际。

参数释义

  • ANALYZE:

执行该命令并显示实际运行时和其他统计数据。该参数默认为 FALSE。

  • VERBOSE:

VERBOSE 用作显示有关计划的其他信息。具体来说,包括计划树中每个节点的输出列列表、模式限定表和函数名称,始终使用范围表别名标记表达式中的变量,并且始终打印显示统计信息的每个触发器的名称。该参数默认为 FALSE。

  • FORMAT:

FORMAT 用作指定输出格式,可以是 TEXT、JSON。非文本输出包含与文本输出格式相同的信息,且容易被程序解析。该参数默认为 TEXT。

  • BOOLEAN:

BOOLEAN 指定所选选项是打开还是关闭。你可以写 TRUE 来启用该选项,或者写 FALSE 来禁用它。

boolean 值也可以省略,省略 boolean 值的情况下默认为 TRUE。

  • STETEMENT

MatrixOne 支持任何 SELECT,UPDATE,DELETE 语句执行计划。在 MatrixOne 0.5.1 版本中仅支持 INSERT 语句类型中的 INSERT INTO..SELECT 语句,暂不支持 INSERT INTO...VALUES 语句。

示例

Node_TABLE_SCAN

1. mysql> explain verbose SELECT N_NAME, N_REGIONKEY a FROM NATION WHERE N_NATIONKEY > 0 OR N_NATIONKEY < 10;
2. +------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                         |
4. +------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                             |
6. |   Output: #[0,0], #[0,1]                                                           |
7. |   ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)      |
8. |         Output: #[0,1], #[0,2]                                                     |
9. |         Table: 'nation' (0:'n_nationkey', 1:'n_name', 2:'n_regionkey')             |
10. |         Filter Cond: ((CAST(#[0,0] AS INT64) > 0) or (CAST(#[0,0] AS INT64) < 10)) |
11. +------------------------------------------------------------------------------------+

Node_VALUE_SCAN

1. mysql> explain verbose select abs(-1);
2. +-----------------------------------------------------------------------------+
3. | QUERY PLAN                                                                  |
4. +-----------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=1.00 ndv=0.00 rowsize=0)                       |
6. |   Output: 1                                                                 |
7. |   ->  Values Scan "*VALUES*" (cost=0.00..0.00 card=1.00 ndv=0.00 rowsize=0) |
8. |         Output: 0                                                           |
9. +-----------------------------------------------------------------------------+

Node_SORT

1. mysql> explain verbose SELECT N_NAME, N_REGIONKEY a FROM NATION WHERE N_NATIONKEY > 0 AND N_NATIONKEY < 10 ORDER BY N_NAME, N_REGIONKEY DESC;
2. +--------------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                                 |
4. +--------------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                     |
6. |   Output: #[0,0], #[0,1]                                                                   |
7. |   ->  Sort(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                  |
8. |         Output: #[0,0], #[0,1]                                                             |
9. |         Sort Key: #[0,0] INTERNAL,  #[0,1] DESC                                            |
10. |         ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                         |
11. |               Output: #[0,0], #[0,1]                                                       |
12. |               ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)  |
13. |                     Output: #[0,1], #[0,2]                                                 |
14. |                     Table: 'nation' (0:'n_nationkey', 1:'n_name', 2:'n_regionkey')         |
15. |                     Filter Cond: (CAST(#[0,0] AS INT64) > 0), (CAST(#[0,0] AS INT64) < 10) |
16. +--------------------------------------------------------------------------------------------+

带有限制和偏移量:

1. mysql> explain SELECT N_NAME, N_REGIONKEY FROM NATION WHERE abs(N_REGIONKEY) > 0 AND N_NAME LIKE '%AA' ORDER BY N_NAME DESC, N_REGIONKEY limit 10;
2. +-------------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                                |
4. +-------------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                    |
6. |   ->  Sort(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                 |
7. |         Sort Key: #[0,0] DESC,  #[0,1] INTERNAL                                           |
8. |         Limit: 10                                                                         |
9. |         ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                        |
10. |               ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
11. |                     Filter Cond: (abs(CAST(#[0,1] AS INT64)) > 0), (#[0,0] like '%AA')    |
12. +-------------------------------------------------------------------------------------------+
1. mysql> explain SELECT N_NAME, N_REGIONKEY FROM NATION WHERE abs(N_REGIONKEY) > 0 AND N_NAME LIKE '%AA' ORDER BY N_NAME DESC, N_REGIONKEY LIMIT 10 offset 20;
2. +-------------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                                |
4. +-------------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                    |
6. |   ->  Sort(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                 |
7. |         Sort Key: #[0,0] DESC,  #[0,1] INTERNAL                                           |
8. |         Limit: 10, Offset: 20                                                             |
9. |         ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                        |
10. |               ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
11. |                     Filter Cond: (abs(CAST(#[0,1] AS INT64)) > 0), (#[0,0] like '%AA')    |
12. +-------------------------------------------------------------------------------------------+

Node_AGG

1. mysql> explain verbose SELECT count(*) FROM NATION group by N_NAME;
2. +-------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                          |
4. +-------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                              |
6. |   Output: #[0,0]                                                                    |
7. |   ->  Aggregate(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                      |
8. |         Output: #[-2,0]                                                             |
9. |         Group Key:#[0,1]                                                            |
10. |         Aggregate Functions: starcount(#[0,0])                                      |
11. |         ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
12. |               Output: #[0,0], #[0,1]                                                |
13. |               Table: 'nation' (0:'n_nationkey', 1:'n_name')                         |
14. +-------------------------------------------------------------------------------------+

Node_JOIN

1. mysql> explain verbose SELECT NATION.N_NAME, REGION.R_NAME FROM NATION join REGION on NATION.N_REGIONKEY = REGION.R_REGIONKEY WHERE NATION.N_REGIONKEY > 10 AND LENGTH(NATION.N_NAME) > LENGTH(REGION.R_NAME);
2. +--------------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                                 |
4. +--------------------------------------------------------------------------------------------+
5. | Project(cost=0.00..0.00 card=125.00 ndv=0.00 rowsize=0)                                    |
6. |   Output: #[0,1], #[0,0]                                                                   |
7. |   ->  Filter(cost=0.00..0.00 card=125.00 ndv=0.00 rowsize=0)                               |
8. |         Output: #[0,0], #[0,1]                                                             |
9. |         Filter Cond: (length(CAST(#[0,1] AS CHAR)) > length(CAST(#[0,0] AS CHAR)))         |
10. |         ->  Join(cost=0.00..0.00 card=125.00 ndv=0.00 rowsize=0)                           |
11. |               Output: #[0,1], #[1,0]                                                       |
12. |               Join Type: INNER                                                             |
13. |               Join Cond: (#[1,1] = #[0,0])                                                 |
14. |               ->  Table Scan on tpch.region(cost=0.00..0.00 card=5.00 ndv=0.00 rowsize=0)  |
15. |                     Output: #[0,0], #[0,1]                                                 |
16. |                     Table: 'region' (0:'r_regionkey', 1:'r_name')                          |
17. |               ->  Table Scan on tpch.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
18. |                     Output: #[0,0], #[0,1]                                                 |
19. |                     Table: 'nation' (0:'n_name', 1:'n_regionkey')                          |
20. |                     Filter Cond: (CAST(#[0,1] AS INT64) > 10)                              |
21. +--------------------------------------------------------------------------------------------+

Node_INSERT

1. mysql> explain verbose INSERT NATION select * from nation;
2. +---------------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                                  |
4. +---------------------------------------------------------------------------------------------+
5. | Insert on db1.nation (cost=0.0..0.0 rows=0 ndv=0 rowsize=0)                                 |
6. |   Output: #[0,0], #[0,1], #[0,2], #[0,3]                                                    |
7. |   ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                                |
8. |         Output: #[0,0], #[0,1], #[0,2], #[0,3]                                              |
9. |         ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)         |
10. |               Output: #[0,0], #[0,1], #[0,2], #[0,3]                                        |
11. |               Table: 'nation' (0:'n_nationkey', 1:'n_name', 2:'n_regionkey', 3:'n_comment') |
12. +---------------------------------------------------------------------------------------------+
13. 7 rows in set (0.00 sec)

Node_Update

1. mysql> explain verbose UPDATE NATION SET N_NAME ='U1', N_REGIONKEY=2 WHERE N_NATIONKEY > 10 LIMIT 20;
2. +-------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                          |
4. +-------------------------------------------------------------------------------------+
5. | Update on db1.nation (cost=0.0..0.0 rows=0 ndv=0 rowsize=0)                         |
6. |   ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                        |
7. |         Output: #[0,0], 'U1', CAST(2 AS INT32)                                      |
8. |         Limit: 20                                                                   |
9. |         ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
10. |               Output: #[0,1]                                                        |
11. |               Table: 'nation' (0:'n_nationkey', 1:'PADDR')                          |
12. |               Filter Cond: (CAST(#[0,0] AS INT64) > 10)                             |
13. +-------------------------------------------------------------------------------------+

Node_Delete

1. mysql> explain verbose DELETE FROM NATION WHERE N_NATIONKEY > 10;
2. +-------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                          |
4. +-------------------------------------------------------------------------------------+
5. | Delete on db1.nation (cost=0.0..0.0 rows=0 ndv=0 rowsize=0)                         |
6. |   ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                        |
7. |         Output: #[0,0]                                                              |
8. |         ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
9. |               Output: #[0,1]                                                        |
10. |               Table: 'nation' (0:'n_nationkey', 1:'PADDR')                          |
11. |               Filter Cond: (CAST(#[0,0] AS INT64) > 10)                             |
12. +-------------------------------------------------------------------------------------+

带有限制:

1. mysql>  explain verbose DELETE FROM NATION WHERE N_NATIONKEY > 10 LIMIT 20;
2. +-------------------------------------------------------------------------------------+
3. | QUERY PLAN                                                                          |
4. +-------------------------------------------------------------------------------------+
5. | Delete on db1.nation (cost=0.0..0.0 rows=0 ndv=0 rowsize=0)                         |
6. |   ->  Project(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0)                        |
7. |         Output: #[0,0]                                                              |
8. |         Limit: 20                                                                   |
9. |         ->  Table Scan on db1.nation(cost=0.00..0.00 card=25.00 ndv=0.00 rowsize=0) |
10. |               Output: #[0,1]                                                        |
11. |               Table: 'nation' (0:'n_nationkey', 1:'PADDR')                          |
12. |               Filter Cond: (CAST(#[0,0] AS INT64) > 10)                             |
13. +-------------------------------------------------------------------------------------+