Jak zwrócić wartość z procedury za pomocą kursora (REF CURSOR)?

W Oracle PL/SQL, aby zwrócić zestaw wierszy z procedury, często używa się REF CURSOR. To wskaźnik na wynik zapytania, który można otworzyć wewnątrz procedury i zwrócić do kodu wywołującego.

Przykład procedury z parametrem OUT typu REF CURSOR:

CREATE OR REPLACE PROCEDURE get_employees(p_dept_id IN NUMBER, p_refcur OUT SYS_REFCURSOR) AS
BEGIN
  OPEN p_refcur FOR
    SELECT employee_id, first_name, last_name
    FROM employees
    WHERE department_id = p_dept_id;
END;
/

Wywołanie z bloku PL/SQL:

DECLARE
  rc SYS_REFCURSOR;
  emp_id employees.employee_id%TYPE;
  fname employees.first_name%TYPE;
  lname employees.last_name%TYPE;
BEGIN
  get_employees(10, rc);
  LOOP
    FETCH rc INTO emp_id, fname, lname;
    EXIT WHEN rc%NOTFOUND;
    DBMS_OUTPUT.PUT_LINE(emp_id || ' ' || fname || ' ' || lname);
  END LOOP;
  CLOSE rc;
END;
/

W ten sposób procedura otwiera REF CURSOR z odpowiednim zapytaniem, a kod wywołujący odczytuje z niego dane.