如何定义显式游标_CURSOR声明与OPEN/FETCH/CLOSE流程

首页

数据库

热心网友

转载

2026-04-26

显式游标必须用 CURSOR 关键字声明，漏写会导致 PLS-00103 编译错误；其本质是用户定义的命名查询，需 OPEN/FETCH/CLOSE 成对使用，循环结束判断应依赖 %NOTFOUND 而非 %ROWCOUNT。

显式游标必须用 `CURSOR` 关键字声明，不能只写 `DECLARE c1`

在 Oracle PL/SQL 编程中，显式游标与隐式游标存在本质区别。显式游标是开发者主动定义并命名的查询对象，而隐式游标则由数据库引擎在执行 DML 语句时自动创建和管理。声明显式游标时，CURSOR 关键字不可或缺，若遗漏将直接触发 PLS-00103: encountered the symbol "is" 等编译错误，导致程序无法通过语法检查。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一个常见的混淆点是将显式游标与游标变量声明相混淆。例如，DECLARE c1 SYS_REFCURSOR; 声明的是一个引用游标变量，属于动态游标范畴，需通过 OPEN ... FOR 动态绑定 SQL 语句。而典型的错误写法 DECLARE c1 IS SELECT ... 则因缺少 CURSOR 关键字而构成无效语法。

CURSOR c1 IS SELECT empno, ename FROM emp WHERE deptno = 10; ✅ 这是标准的显式游标声明语法。
DECLARE c1 SYS_REFCURSOR; → 此声明用于游标变量，后续需使用 OPEN c1 FOR ... 动态关联查询，属于不同的游标类型。
此外，游标名称必须在作用域内保持唯一，且不能与现有变量名冲突，否则会引发 PLS-00320 标识符重复定义错误。

`OPEN`/`FETCH`/`CLOSE` 必须成对出现，且 `FETCH` 前必须 `OPEN`

显式游标遵循严格的生命周期管理：通过 OPEN 操作初始化并定位到结果集起始位置；每次执行 FETCH 获取当前行数据并移动指针；最终通过 CLOSE 释放资源。若未执行 OPEN 而直接 FETCH，将抛出 ORA-01001: invalid cursor 运行时异常。尽管忘记 CLOSE 可能不会立即报错，但在高并发或长周期运行的应用程序（如包中的重复调用）中，可能导致游标资源泄漏，逐渐耗尽数据库会话的游标上限，严重影响系统性能与稳定性。

标准操作顺序应为：OPEN c1; → FETCH c1 INTO v_empno, v_ename; → 循环处理 → CLOSE c1;。
控制循环终止的正确依据是游标的 %NOTFOUND 属性，而非 %ROWCOUNT。
CLOSE c1; 应在数据遍历完成后执行，为确保资源释放，建议在异常处理块中也包含关闭游标的逻辑。
还需注意，应避免在循环体内重复 OPEN 和 CLOSE 同一游标，这种模式会带来不必要的性能开销。

游标参数化时，`OPEN` 传参顺序和类型必须严格匹配声明

为显式游标添加参数（例如 CURSOR c1(p_deptno NUMBER) IS SELECT ... WHERE deptno = p_deptno;）可提升其复用性与灵活性，使其类似于带参数的函数。但在调用时需格外谨慎：游标参数传递严格依赖位置顺序和数据类型声明，不具备自动类型推导或命名参数匹配能力。若参数顺序错乱或类型不兼容，可能在编译期无法察觉，但在运行时可能导致查询无结果或隐式转换失败错误。

OPEN c1(10); ✅ 此调用方式与 p_deptno NUMBER 声明完全匹配。
OPEN c1('10'); → 虽然字符串 ‘10’ 在多数情况下可隐式转换为数字，但若目标字段为 VARCHAR2 或包含非数字字符，则可能引发转换异常或逻辑错误。
当游标包含多个参数时，传递顺序必须与声明顺序严格一致，且不支持使用命名参数语法（如 name => value）。
还需注意，游标参数仅支持 IN 模式，不可在游标内部对其赋值，也不支持设置默认值。

别在 `FETCH` 后直接用 `%ROWCOUNT` 判断是否取到数据

此处存在一个典型误区：%ROWCOUNT 属性记录的是自游标打开后成功 FETCH 的行数累计值。首次 FETCH 前其值为 0；成功获取第一行后变为 1。然而，仅凭该数值无法区分“当前 FETCH 成功获取数据”与“已遍历完所有数据、最后一次 FETCH 失败”这两种状态。真正用于判断循环是否应结束的可靠依据是 %NOTFOUND 属性。

错误示例：IF c1%ROWCOUNT = 0 THEN ... —— 即使游标包含数据，只要未执行 FETCH，%ROWCOUNT 始终为 0，这不能证明结果集为空。
正确模式：FETCH c1 INTO ...; EXIT WHEN c1%NOTFOUND; 这是控制游标循环退出的标准写法。
需牢记：%FOUND 与 %NOTFOUND 属性仅在执行至少一次 FETCH 操作后才具有明确定义的状态，首次 FETCH 前其状态为未初始化。
另一个关键点：若游标结果集本身为空，则首次 FETCH 会立即将 %NOTFOUND 置为 TRUE，且该过程不会抛出任何异常。