显式游标必须用 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,且该过程不会抛出任何异常。
在实际开发中,最易疏忽的两大风险点恰恰是:在异常处理分支中遗漏游标的 CLOSE 操作,以及参数传递时依赖不可靠的隐式类型转换。代码可能在特定测试数据下运行正常,一旦数据环境变化,便可能引发运行时故障,需引起高度重视。
