164 Star 224 Fork 1.2K

openGauss / docs

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
EXPLAIN-PLAN.md 2.63 KB
一键复制 编辑 原始数据 按行查看 历史
tongdabao 提交于 2021-09-10 17:19 . feature

EXPLAIN PLAN

功能描述

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

语法格式

EXPLAIN PLAN
[ SET STATEMENT_ID = string ]
FOR statement ;

参数说明

  • EXPLAIN中的PLAN选项表示需要将计划信息存储于PLAN_TABLE中,存储成功将返回“EXPLAIN SUCCESS”。

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

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

注意事项

  • EXPLAIN PLAN不支持在数据库节点上执行。
  • 对于执行错误的SQL无法进行计划信息的收集。
  • PLAN_TABLE中的数据是session级生命周期并且session隔离和用户隔离,用户只能看到当前session、当前用户的数据。

示例 1

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

  1. 执行EXPLAN PLAN。

    说明: 执行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;
  2. 查询PLAN_TABLE。

    SELECT * FROM PLAN_TABLE;

  3. 清理PLAN_TABLE表中的数据。

    DELETE FROM PLAN_TABLE WHERE xxx;
1
https://gitee.com/opengauss/docs.git
git@gitee.com:opengauss/docs.git
opengauss
docs
docs
2.1.0

搜索帮助