A REF Cursor can be opened on the server and passed to the client as a unit rather than fetching one row at a time. One can use a Ref Cursor as target of an assignment, and it can be passed as parameter to other program units. Ref Cursors are opened with an OPEN FOR statement. In most other ways they behave similar to normal cursors.
This feature was introduced with PL/SQL v2.3 (Oracle 7.3).
Create a function that opens a cursor and returns a reference to it:
CREATE OR REPLACE FUNCTION f RETURN SYS_REFCURSOR AS c SYS_REFCURSOR; BEGIN OPEN c FOR select * from dual; RETURN c; END; /
Call the above function and fetch all rows from the cursor it returns:
set serveroutput on DECLARE c SYS_REFCURSOR; v VARCHAR2(1); BEGIN c := f(); -- Get ref cursor from function LOOP FETCH c into v; EXIT WHEN c%NOTFOUND; dbms_output.put_line('Value from cursor: '||v); END LOOP; END; /
|Glossary of Terms