Использование неявных курсоров при DML-операциях

Наверняка у многих возникала необходимость внутри PL\SQL блока проверить, сколько строк было вставлено, удалено или обновлено последней DML-операцией. Все знают, что где-то оно должно быть, но не все представляют где. В SQL*Plus да и в различных оболочках для работы с БД мы видим надписи:

SQL> UPDATE test_tab t SET t.col1=1;

3 rows updated

Но как проверить результат выполнения в коде?


Для подобных целей в СУБД Oracle предусмотрен неявный курсор, который позволяет читать информацию о последнем отработавшем курсоре. Удивительно, но имя ему SQL!

Данный неявный курсор имеет следующие атрибуты: %FOUND, %ISOPEN, %NOTFOUND, и %ROWCOUNT.

%FOUND показывает, было ли изменение строк.

%NOTFOUND - DML-операция не смогла изменить строки.

%ROWCOUNT - на какое количество строк распространялась DML-операция.

%ISOPEN - всегда FALSE, т.к. СУБД закрывает все курсоры, связанные с SQL-выражением, сразу после завершения DML-операции.

Пример из официальной документации:

CREATE TABLE employees_temp AS SELECT * FROM employees;
BEGIN
  UPDATE employees_temp 
     SET salary = salary * 1.05 
   WHERE salary < 5000;

  DBMS_OUTPUT.PUT_LINE('Updated ' || SQL%ROWCOUNT || 
                       ' salaries.');
END;
/

Источник.