--- title: "DISPLAY_CURSOR - OceanBase 数据库 V4.2.2 | OceanBase 文档中心" description: "DISPLAY_CURSOR DISPLAY_CURSOR 函数用于用于展示已执行的查询计划详情。 函数定义 DBMS_XPLAN.DISPLAY_CURSOR(plan_id INTEGER DEFAULT 0, -- default value: last plan format VARCHAR2 DEFAULT…" --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.2 # DISPLAY_CURSOR 更新时间：2026-04-10 11:58:36 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.2/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` 函数用于用于展示已执行的查询计划详情。 ## 函数定义 ```sql DBMS_XPLAN.DISPLAY_CURSOR(plan_id INTEGER DEFAULT 0, -- default value: last plan format VARCHAR2 DEFAULT 'TYPICAL', svr_ip VARCHAR2 DEFAULT null, -- default value: server connected by client svr_port INTEGER DEFAULT 0, -- default value: server connected by client tenant_id INTEGER DEFAULT 0 -- default value: current tenant ) 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 当前连接的租户。 | ## 示例 MySQL 租户由于没有 Function Table 功能，可以直接在 `SELECT` 语句里面使用 `DISPLAY_CURSOR` 函数输出计划信息。 ```shell /* 创建表 */ obclient> CREATE TABLE t1(c1 INT); Query OK, 0 rows affected /* 执行查询 */ obclient> SELECT * FROM t1; Empty set /* 使用 DBMS_XPLAN 包查看历史计划 */ obclient> SELECT DBMS_XPLAN.DISPLAY_CURSOR() ; +--------------------------------------------------------------------------------------------------+ | COLUMN_VALUE | +--------------------------------------------------------------------------------------------------+ | ================================================================================================ | | |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 |2 |0 |0 |0 |0 | | | ================================================================================================ | | Outputs & filters: | | ------------------------------------- | | 0 - output([T1.C1]), filter(nil), rowset=256 | | access([T1.C1]), partitions(p0) | | is_index_back=false, is_global_index=false, | | range_key([T1.__pk_increment]), range(MIN ; MAX)always true | +--------------------------------------------------------------------------------------------------+ /* 也可以指定(tenant_id, svr_ip, svr_port, plan_id)四元组查询指定计划信息 */ obclient> SELECT DBMS_XPLAN.DISPLAY_CURSOR( 123, 'typical', '127.0.0.1', 2828, 1002 ) FROM DUAL; +--------------------------------------------------------------------------------+ | dbms_xplan.display_cursor( 123, 'typical', '127.x.x.1', 2828, 1002 ) | +--------------------------------------------------------------------------------+ | | +--------------------------------------------------------------------------------+ 1 row in set ``` 上一篇 下一篇 ![有帮助](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) 咨询热线