--- title: "DISPLAY_CURSOR - OceanBase 数据库 V4.2.5 | OceanBase 文档中心" description: DISPLAY_CURSOR DISPLAY_CURSOR 函数用于用于展示已执行的查询计划详情。 功能适用性 OceanBase 数据库社区版从 V4.2.5 版本开始支持该功能。 语法 DBMS_XPLAN.DISPLAY_CURSOR(plan_id DECIMAL DEFAULT 0, -- default … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.5 LTS # DISPLAY_CURSOR 更新时间：2026-07-15 20:42:47 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/500.sql-reference/300.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/20700.dbms-xplan-mysql/300.display-cursor-of-mysql-mode.md) `DISPLAY_CURSOR` 函数用于用于展示已执行的查询计划详情。 #### 功能适用性 OceanBase 数据库社区版从 V4.2.5 版本开始支持该功能。 ## 语法 ```sql DBMS_XPLAN.DISPLAY_CURSOR(plan_id DECIMAL DEFAULT 0, -- default value: last plan format VARCHAR(32) DEFAULT 'TYPICAL', svr_ip VARCHAR(64) DEFAULT null, -- default value: server connected by client svr_port DECIMAL DEFAULT 0, -- default value: server connected by client tenant_id DECIMAL DEFAULT 0, -- default value: current tenant sql_handle VARCHAR(32) DEFAULT NULL, plan_name VARCHAR(32) DEFAULT NULL ) RETURN DBMS_XPLAN_TYPE_TABLE; ``` ## 参数解释 | 参数 | 说明 | | --- | --- | | plan_id | 执行计划的 ID。如果不指定，则使用上一次执行的计划。 | | format | 指定计划格式信息，可选参数如下： - `'BASIC'`：展示少量信息，例如算子 ID、算子名称、算子备注信息、表达式信息。 - `'TYPICAL'`：展示基础信息，例如算子 ID、算子名称、算子备注信息、优化器估计的输出行数、优化器估计的执行时间，表达式信息。如果该计划执行过，还会展示计划第一次执行真实反馈信息，例如真实行数，开销等等。 - `'ALL'`：展示丰富的计划信息，例如算子 ID、算子名称、算子备注信息、优化器估计的输出行数、优化器估计的执行时间，表达式信息、生效的 Hint、Query Block Name Trace 信息、Outline 信息、基表优化信息、常量参数化信息、约束信息、Plan Note 等。 - `'ADVANCED'`：展示丰富的计划信息，计划信息与 'ALL' 参数一致，除此之外还为复杂的计划展示树状结构信息。 | | svr_ip | 计划所在的节点 IP，默认是 Session 连接的节点 IP。 | | svr_port | 计划所在的节点端口号，默认是 Session 连接的节点端口号。 | | tenant_id | 计划所属租户 ID，默认是 Session 当前连接的租户。 | | sql_handle | 执行计划用于标识 SQL 语句的句柄（Handle）。当查询某条 SQL 语句的特定执行计划时，在存在多条相似 SQL 时，可通过 sql_handle 精准指定目标语句。 | | plan_name | 执行计划的名称。 | ## 示例 MySQL 租户由于没有 Function Table 功能，可以直接在 `SELECT` 语句里面使用 `DISPLAY_CURSOR` 函数输出计划信息。 1. 创建表。 ```shell obclient [test]> CREATE TABLE t1(c1 INT); ``` 2. 执行查询。 ```shell obclient [test]> SELECT * FROM t1; ``` 3. 使用 `DBMS_XPLAN` 包查看历史计划。 - 不指定参数查询。 ```shell obclient [test]> SELECT DBMS_XPLAN.DISPLAY_CURSOR() ; ``` 查询结果如下： ```shell +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | DBMS_XPLAN.DISPLAY_CURSOR() | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | ================================================================================================ |ID|OPERATOR |NAME|EST.ROWS|EST.TIME(us)|REAL.ROWS|REAL.TIME(us)|IO TIME(us)|CPU TIME(us)| ------------------------------------------------------------------------------------------------ |0 |TABLE FULL SCAN|t1 |1 |4 |0 |0 |0 |155 | ================================================================================================ Outputs & filters: ------------------------------------- 0 - output([t1.c1]), filter(nil), rowset=16 access([t1.c1]), partitions(p0) is_index_back=false, is_global_index=false, range_key([t1.__pk_increment]), range(MIN ; MAX)always true | +---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 1 row in set (0.173 sec) ``` - 指定参数查询。 ```shell obclient [test]> SELECT DBMS_XPLAN.DISPLAY_CURSOR(294, 'typical', 'xx.xx.xx.xx', 2828, 1002, '07E5B378A3CD3778A58E18DB9AD2A430', '7420493073239164301') FROM DUAL; ``` 查询结果如下： ```shell +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | DBMS_XPLAN.DISPLAY_CURSOR( 294, 'typical', 'xx.xx.xx.xx', 2828, 1002, '07E5B378A3CD3778A58E18DB9AD2A430', '7420493073239164301' ) | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | | +----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ 1 row in set (0.005 sec) ``` 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线