更新时间:2024-05-07 GMT+08:00

EXPLAIN PLAN

功能描述

通过EXPLAIN PLAN命令可以将查询执行的计划信息存储于PLAN_TABLE表中。与EXPLAIN命令不同的是,EXPLAIN PLAN仅将计划信息进行存储,而不会打印到屏幕。

语法格式

1
2
3
EXPLAIN PLAN
[ SET STATEMENT_ID = string ]
FOR statement ;

参数说明

  • EXPLAIN中的PLAN选项表示需要将计划信息存储于PLAN_TABLE中,存储成功将返回“EXPLAIN SUCCESS”。
  • 用户可通过STATEMENT_ID对查询设置标签,输入的标签信息也将存储于PLAN_TABLE中。

    用户在执行EXPLAIN PLAN时,如果没有设置STATEMENT_ID,则默认为空值。同时,用户可输入的STATEMENT_ID最大长度为30个字节,超过长度将会产生报错。

注意事项

  • EXPLAIN PLAN不支持在DN上执行。
  • 对于执行错误的SQL语句无法进行计划信息的收集。
  • PLAN_TABLE中的数据是session级生命周期并且session隔离和用户隔离,用户只能看到当前session、当前用户的数据。
  • PLAN_TABLE无法与GDS外表进行关联查询。
  • 对于不能下推的查询,无法收集到具体的object信息,object只能收集到REMOTE_QUERY或CTE等信息。详见示例 2

示例 1

使用EXPLAIN PLAN收集SQL语句的执行计划,通常包括以下步骤:

  1. 执行EXPLAN PLAN。

    执行EXPLAIN PLAN 后会将计划信息自动存储于PLAN_TABLE中,不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。

    PLAN_TABLE详细介绍见PLAN_TABLE

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    explain plan set statement_id='TPCH-Q4' for
    select
    o_orderpriority,
    count(*) as order_count
    from
    orders
    where
    o_orderdate >= '1993-07-01'::date
    and o_orderdate < '1993-07-01'::date + interval '3 month'
    and exists (
    select
    *
    from
    lineitem
    where
    l_orderkey = o_orderkey
    and l_commitdate < l_receiptdate
    )
    group by
    o_orderpriority
    order by
    o_orderpriority;
    

  2. 查询PLAN_TABLE。

    SELECT * FROM PLAN_TABLE;

  3. 清理PLAN_TABLE表中的数据。

    1
    DELETE FROM PLAN_TABLE WHERE xxx;
    

示例 2

对于不能下推的查询,执行explain plan后plan_table中object仅收集到REMOTE_QUERY或CTE等信息。

场景一:优化器生成下发语句的计划,此时仅能收集到REMOTE_QUERY。
1
2
3
4
5
  explain plan set statement_id = 'test remote query' for
  select
  current_user
  from 
  customer;
查询PLAN_TABLE。
1
SELECT * FROM PLAN_TABLE;

场景二:对于with recursive场景中不能下推的查询,仅能收集到CTE。

关闭enable_stream_recursive,使得查询不能下推。
1
set enable_stream_recursive = off;
执行explain plan SQL
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
explain plan set statement_id = 'cte can not be push down'
for
with recursive rq as
(
  select id, name from  chinamap where id = 11
  union all
  select origin.id, rq.name || ' > ' || origin.name
  from rq join chinamap origin on origin.pid = rq.id
)
select id, name from rq order by 1;
查询PLAN_TABLE。
1
SELECT * FROM PLAN_TABLE;