# EXPLAIN PLAN
#### 功能描述
通过EXPLAIN PLAN命令可以将查询执行的计划信息存储于PLAN_TABLE表中。与EXPLAIN命令不同的是，EXPLAIN PLAN仅将计划信息进行存储，而不会打印到屏幕。
#### 语法格式
```
EXPLAIN PLAN
[ SET STATEMENT_ID = string ]
FOR statement ;
```
#### 参数说明
表1EXPLAIN PLAN参数说明 
| 参数           | 描述                                                                                                                                                                                   |
|:---|:---|
| 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. 导入TPC-H样例数据。具体步骤参见[导入样例数据](https://support.huaweicloud.com/bestpractice-dws/dws_05_0044.html#section3)。
2. 执行EXPLAIN PLAN。 
   ![](https://support.huaweicloud.com/sqlreference-dws/public_sys-resources/note_3.0-zh-cn.png)
   执行EXPLAIN PLAN后会将计划信息自动存储于PLAN_TABLE中，不支持对PLAN_TABLE进行INSERT、UPDATE、ANALYZE等操作。
   PLAN_TABLE详细介绍见视图PLAN_TABLE。
   ```
   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;
   ```
   
   
3. 查询PLAN_TABLE。 
   ```
   SELECT * FROM PLAN_TABLE;
   ```
   ![](https://support.huaweicloud.com/sqlreference-dws/figure/zh-cn_image_0000001811634921.png "点击放大")
   
   
4. 清理PLAN_TABLE表中的数据。 
   ```
   DELETE FROM PLAN_TABLE WHERE xxx;
   ```
   
   
 
 #### 示例 2
对于不能下推的查询，执行explain plan后plan_table中object仅收集到REMOTE_QUERY或CTE等信息。
优化器生成下发语句的计划，此时仅能收集到REMOTE_QUERY。
```
explain plan set statement_id = 'test remote query' for
  select
  current_user
  from 
  customer;
```
查询PLAN_TABLE。
```
SELECT * FROM PLAN_TABLE;
```
![](https://support.huaweicloud.com/sqlreference-dws/figure/zh-cn_image_0000001811515849.png "点击放大")