【Oracle】ORA-01001の原因と解決方法｜invalid cursor の直し方

ORA-01001: invalid cursor は、Oracleで無効なカーソルを操作した時に発生するエラーです。PL/SQLでは、まだ OPEN していないカーソルを FETCH した、すでに CLOSE したカーソルを再度操作した、カーソル属性を不正な状態で参照した、といったケースで起きます。

Oracle公式のORA-01001説明では、無効なカーソル番号や存在しないカーソルが指定されたことが原因として説明されています。PL/SQL側では、OPEN、FETCH、CLOSE の順序と、カーソルが開いているかを確認するのが基本です。

ORA-01001とは

ORA-01001は、カーソルが有効な状態ではないのに操作したことを示します。明示的カーソルやカーソル変数では、状態に応じて使える操作が変わります。

Oracle公式のPL/SQLカーソル説明でも、明示的カーソルはOPEN、FETCH、CLOSEの流れで扱い、開いていないカーソルに対して一部の属性や操作を行うと INVALID_CURSOR 例外になります。

発生する典型例

次の例では、カーソルを OPEN せずに FETCH しています。カーソルが有効な実行状態にないため、ORA-01001になります。

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
  l_id employees.employee_id%TYPE;
BEGIN
  FETCH c_emp INTO l_id;
END;
/

-- ORA-01001: invalid cursor

明示的カーソルの基本は 明示的カーソル完全ガイド にもまとめています。

CLOSE後にFETCHするケース

カーソルを一度閉じた後に、同じカーソルからFETCHしようとしてもORA-01001になります。CLOSE後に再利用する場合は、再度 OPEN してからFETCHします。

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
  l_id employees.employee_id%TYPE;
BEGIN
  OPEN c_emp;
  CLOSE c_emp;

  FETCH c_emp INTO l_id;
END;
/

-- CLOSE後なのでORA-01001

基本の直し方

カーソルを手動で扱う場合は、OPEN してから FETCH し、最後に CLOSE します。状態が分からない場合は %ISOPEN で確認します。

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
  l_id employees.employee_id%TYPE;
BEGIN
  OPEN c_emp;

  LOOP
    FETCH c_emp INTO l_id;
    EXIT WHEN c_emp%NOTFOUND;
    DBMS_OUTPUT.PUT_LINE(l_id);
  END LOOP;

  CLOSE c_emp;
END;
/

操作別の最短修正

ORA-01001は、どの操作で落ちたかを見ると早く切り分けられます。エラー行が FETCH なのか、CLOSE なのか、属性参照なのかをまず確認します。

症状別の最短修正

ORA-01001は、カーソルの状態と操作の順序を見ると切り分けやすいです。発生行の操作ごとに、次のように確認します。

カーソル属性で起きる場合

%FOUND、%NOTFOUND、%ROWCOUNT は便利ですが、カーソルが正しい状態でないとエラーになります。%ISOPEN は状態確認に使いやすい属性です。

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
BEGIN
  IF c_emp%NOTFOUND THEN
    DBMS_OUTPUT.PUT_LINE('no rows');
  END IF;
END;
/

-- OPENもFETCHもしていないため不正

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
  l_id employees.employee_id%TYPE;
BEGIN
  OPEN c_emp;
  FETCH c_emp INTO l_id;

  IF c_emp%NOTFOUND THEN
    DBMS_OUTPUT.PUT_LINE('no rows');
  END IF;

  CLOSE c_emp;
END;
/

ORA-06511との違い

ORA-01001とORA-06511はどちらもカーソル状態の問題ですが、逆方向のエラーです。ORA-06511は開いているカーソルをまた開いた時、ORA-01001は開いていない・無効なカーソルを操作した時に起きます。

カーソルFORループに置き換える

手動のOPEN/FETCH/CLOSEが不要なら、カーソルFORループに置き換えると状態管理のミスを減らせます。PL/SQLがOPEN、FETCH、CLOSEを管理するため、ORA-01001やORA-06511の原因を減らしやすいです。

BEGIN
  FOR r IN (
    SELECT employee_id
    FROM employees
  ) LOOP
    DBMS_OUTPUT.PUT_LINE(r.employee_id);
  END LOOP;
END;
/

カーソルFORループと明示的カーソルの使い分けは PL/SQLカーソル完全ガイド も参考になります。

REF CURSORやアプリ側で起きる場合

REF CURSORをアプリケーションへ返す処理では、DB側・アプリ側のどちらで閉じるかが曖昧だとORA-01001につながることがあります。Java、C#、Python、PHPなどでは、ResultSetやCursorを閉じた後に読み続けていないか、接続やトランザクションの終了でカーソルが無効になっていないかを確認します。

REF CURSORを返す側・読む側の責任分界

REF CURSORを返す設計では、DB側はカーソルを開いて返し、呼び出し側は読み終わってから閉じる、という責任分界を明確にします。返す前に閉じたり、呼び出し側が読む前に接続を閉じたりすると、ORA-01001につながりやすくなります。

CREATE OR REPLACE PROCEDURE p_get_emps(p_cur OUT SYS_REFCURSOR) IS
BEGIN
  OPEN p_cur FOR
    SELECT employee_id, last_name
    FROM employees;
END;
/

-- 呼び出し側が読み終わるまで、接続やカーソルを閉じるタイミングに注意する

例外処理で順序が崩れる場合

例外ハンドラでカーソルを閉じた後、外側の処理が同じカーソルをFETCHし続けるとORA-01001になり得ます。例外時は状態を整理し、必要なら処理を中断します。

DECLARE
  CURSOR c_emp IS
    SELECT employee_id
    FROM employees;
  l_id employees.employee_id%TYPE;
BEGIN
  OPEN c_emp;
  FETCH c_emp INTO l_id;

  CLOSE c_emp;
EXCEPTION
  WHEN OTHERS THEN
    IF c_emp%ISOPEN THEN
      CLOSE c_emp;
    END IF;
    RAISE;
END;
/

例外処理の設計は PL/SQL例外処理ガイド も参考になります。

調査手順

PL/SQL内でORA-01001が出た場合は、ORA-06512の行番号から USER_SOURCE で該当行を確認します。その行がFETCHなのか、CLOSEなのか、カーソル属性参照なのかを見て、直前のOPEN/CLOSE順序を追います。

SELECT line,
       text
FROM user_source
WHERE name = 'PKG_EMP'
  AND type = 'PACKAGE BODY'
  AND line BETWEEN 60 AND 90
ORDER BY line;

発生行の読み方は ORA-06512の原因と読み方、バックトレースのログは DBMS_UTILITY完全ガイド が参考になります。

よくある原因と対処一覧

チェックリスト

よくある質問

ORA-01001とORA-06511は何が違いますか？

ORA-01001は無効なカーソルを操作した時、ORA-06511はOPEN済みカーソルを再度OPENした時です。

%ISOPENを見れば防げますか？

状態確認には有効です。ただし、FETCHや属性参照の順序が間違っている場合は、OPEN/FETCH/CLOSEの流れ自体を直します。

カーソルFORループなら安全ですか？

手動OPEN/FETCH/CLOSEが不要になるため、状態管理ミスは減らせます。単純な全件処理では有力な選択肢です。

アプリ側でだけORA-01001になります

ResultSet/Cursor、接続、トランザクションを閉じるタイミングを確認してください。DBから返したカーソルを読み終える前に閉じている可能性があります。

まとめ

ORA-01001は、無効なカーソルや閉じたカーソルを操作した時に発生します。OPEN前のFETCH、CLOSE後のFETCH、カーソル属性参照の順序ミス、アプリ側で閉じた後の読み取りが主な原因です。

対処は、OPEN/FETCH/CLOSEの順序を整理し、必要なら %ISOPEN で状態を確認することです。単純な処理ならカーソルFORループへ置き換えると、カーソル状態の管理ミスを減らせます。

参考

ORA-01001 – Oracle Database Error Help

Cursors Overview – Oracle Database PL/SQL Language Reference

Cursor Attributes – Oracle PL/SQL User's Guide and Reference