文档首页/ 数据仓库服务 GaussDB(DWS)/ 更多文档/ 语法参考（巴黎区域）/ DML语法/ EXPLAIN PLAN
更新时间：2022-07-29 GMT+08:00
查看PDF
分享

EXPLAIN PLAN

功能描述

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

语法格式

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

参数说明

  • PLAN

    表示需要将计划信息存储于PLAN_TABLE中，存储成功将返回“EXPLAIN SUCCESS”。

  • STATEMENT_ID
    用户可以对查询设置标签，输入的标签信息也将存储于PLAN_TABLE中。

    用户在执行EXPLAIN PLAN时，如果没有进行SET 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;

父主题： DML语法