描述

该语句用于解释 SQL 语句的执行计划，可以是 SELECT、DELETE、INSERT、REPLACE 或 UPDATE 语句。提供正则过滤功能，通过 session 变量 explain_regex 对输出行 /JSON 进行过滤。

格式

  1. 获取表或列的信息：
  2. {EXPLAIN | DESCRIBE | DESC} tbl_name [col_name | wild]
  4. 获取SQL计划信息：
  5. {EXPLAIN} 
  6. [BASIC | OUTLINE | EXTENDED | EXTENDED_NOADDR | PARTITIONS | FORMAT = {TRADITIONAL| JSON}] 
  7. {SELECT statement | DELETE statement | INSERT statement | UPDATE statement | MERGE statement}

参数解释

参数

描述

tbl_name

指定表名。

col_name

指定表的列名。

BASIC指定输出计划的基础信息，如算子ID、算子名称、所引用的表名。
OUTLINE指定输出的计划信息包含outline信息。
EXTENDEDEXPLAIN产生附加信息，包括：每个算子的输入列和输出列，访问表的分区信息，当前使用的filter信息，如果当前算子使用了索引，显示所使用的索引列及抽取的query range。
EXTENDED_NOADDR以简约的方式展示附加信息。
PARTITIONS显示分区相关信息。
FORMAT = {TRADITIONAL| JSON}

指定EXPALIN的输出格式：

  • TRADITIONAL：表格输出格式
  • JSON：KEY:VALUE输出格式, JSON显示为JSON字符串，包括EXTENDED和PARTITIONS信息。

示例

  • 省略 explain_type
  1. OceanBase(admin@test)>explain select * from t1,t2 where t1.c2=t2.c2 and t2.c1 > 4\G
  2. *************************** 1. row ***************************
  3. Query Plan: =======================================
  4. |ID|OPERATOR   |NAME|EST. ROWS|COST   |
  5. ---------------------------------------
  6. |0 |HASH JOIN  |    |9801000  |5933109|
  7. |1 | TABLE SCAN|t2  |10000    |6219   |
  8. |2 | TABLE SCAN|t1  |100000   |68478  |
  9. =======================================
  11. Outputs & filters: 
  12. -------------------------------------
  13.   0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), 
  14.       equal_conds([t1.c2 = t2.c2]), other_conds(nil)
  15.   1 - output([t2.c2], [t2.c1]), filter(nil), 
  16.       access([t2.c2], [t2.c1]), partitions(p0)
  17.   2 - output([t1.c2], [t1.c1]), filter(nil), 
  18.       access([t1.c2], [t1.c1]), partitions(p0)
  • EXTENDED
  1. OceanBase(admin@test)>explain extended_noaddr select * from t1,t2 where t1.c2=t2.c2 and t2.c1 > 4\G
  2. *************************** 1. row ***************************
  3. Query Plan: =======================================
  4. |ID|OPERATOR   |NAME|EST. ROWS|COST   |
  5. ---------------------------------------
  6. |0 |HASH JOIN  |    |9801000  |5933109|
  7. |1 | TABLE SCAN|t2  |10000    |6219   |
  8. |2 | TABLE SCAN|t1  |100000   |68478  |
  9. =======================================
  11. Outputs & filters: 
  12. -------------------------------------
  13.   0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), 
  14.       equal_conds([t1.c2 = t2.c2]), other_conds(nil)
  15.   1 - output([t2.c2], [t2.c1]), filter(nil), 
  16.       access([t2.c2], [t2.c1]), partitions(p0), 
  17.       is_index_back=false, 
  18.       range_key([t2.c1]), range(4 ; MAX), 
  19.       range_cond([t2.c1 > 4])
  20.   2 - output([t1.c2], [t1.c1]), filter(nil), 
  21.       access([t1.c2], [t1.c1]), partitions(p0), 
  22.       is_index_back=false, 
  23.       range_key([t1.__pk_increment], [t1.__pk_cluster_id], [t1.__pk_partition_id]), range(MIN,MIN,MIN ; MAX,MAX,MAX)always true
  • TRADITIONAL格式
  1. OceanBase(admin@test)>explain format=TRADITIONAL select * from t1,t2 where t1.c2=t2.c2 and t2.c1 > 4\G
  2. *************************** 1. row ***************************
  3. Query Plan: =======================================
  4. |ID|OPERATOR   |NAME|EST. ROWS|COST   |
  5. ---------------------------------------
  6. |0 |HASH JOIN  |    |9801000  |5933109|
  7. |1 | TABLE SCAN|t2  |10000    |6219   |
  8. |2 | TABLE SCAN|t1  |100000   |68478  |
  9. =======================================
  11. Outputs & filters: 
  12. -------------------------------------
  13.   0 - output([t1.c1], [t1.c2], [t2.c1], [t2.c2]), filter(nil), 
  14.       equal_conds([t1.c2 = t2.c2]), other_conds(nil)
  15.   1 - output([t2.c2], [t2.c1]), filter(nil), 
  16.       access([t2.c2], [t2.c1]), partitions(p0)
  17.   2 - output([t1.c2], [t1.c1]), filter(nil), 
  18.       access([t1.c2], [t1.c1]), partitions(p0)
  • JSON格式
  1. OceanBase(admin@test)>explain format=JSON select * from t1,t2 where t1.c2=t2.c2 and t2.c1 > 4\G
  2. *************************** 1. row ***************************
  3. Query Plan: {
  4.   "ID":2,
  5.   "OPERATOR":"JOIN",
  6.   "NAME":"JOIN",
  7.   "EST.ROWS":9800999,
  8.   "COST":5933108,
  9.   "output": [
  10.     "t1.c1",
  11.     "t1.c2",
  12.     "t2.c1",
  13.     "t2.c2"
  14.   ],
  15.   "TABLE SCAN": {
  16.     "ID":0,
  17.     "OPERATOR":"TABLE SCAN",
  18.     "NAME":"TABLE SCAN",
  19.     "EST.ROWS":10000,
  20.     "COST":6218,
  21.     "output": [
  22.       "t2.c2",
  23.       "t2.c1"
  24.     ]
  25.   },
  26.   "TABLE SCAN": {
  27.     "ID":1,
  28.     "OPERATOR":"TABLE SCAN",
  29.     "NAME":"TABLE SCAN",
  30.     "EST.ROWS":100000,
  31.     "COST":68477,
  32.     "output": [
  33.       "t1.c2",
  34.       "t1.c1"
  35.     ]
  36.   }
  37. }

EXPLAIN 的每个输出行提供一个表的相关信息，并且每个行包括下面的列：

列名

说明

ID

计划执行序列号。

OPERATOR

执行算子。

NAME

算子所引用的表。

EST.ROWS

估计执行到当前算子输出的行数。

COST

执行到当前算子的CPU时间。