1.The RETURNING INTO clause allows us to return column values for rows affected by DML statements. The following test table is used to demonstrate this clause.
DROP TABLE t1; DROP SEQUENCE t1_seq; CREATE TABLE t1 ( ID NUMBER(10), DESCRIPTION VARCHAR2(50), CONSTRAINT t1_pk PRIMARY KEY (id)); CREATE SEQUENCE t1_seq; INSERT INTO t1 VALUES (t1_seq.nextval, 'ONE'); INSERT INTO t1 VALUES (t1_seq.nextval, 'TWO'); INSERT INTO t1 VALUES (t1_seq.nextval, 'THREE'); COMMIT;
2.When we insert data using a sequence to generate our primary key value, we can return the primary key value as follows.
SET SERVEROUTPUT ON DECLARE v_id t1.id%TYPE; BEGIN INSERT INTO t1 VALUES (t1_seq.nextval, 'FOUR') RETURNING id INTO v_id; COMMIT; DBMS_OUTPUT.put_line('ID=' || v_id); END; /
ID = 4
3.The syntax is also available for update and delete statements.
SET SERVEROUTPUT ON DECLARE v_id t1.id%TYPE; BEGIN UPDATE t1 SET description = description WHERE description = 'FOUR' RETURNING id INTO v_id; DBMS_OUTPUT.put_line('UPDATE ID=' || v_id); DELETE FROM t1 WHERE description = 'FOUR' RETURNING id INTO v_id; DBMS_OUTPUT.put_line('DELETE ID=' || v_id); COMMIT; END; /
UPDATE ID = 4
DELETE ID = 4
4.When DML affects multiple rows we can still use the RETURNING INTO, but now we must return the values into a collection using the BULK COLLECT clause.
SET SERVEROUTPUT ON DECLARE TYPE t_tab IS TABLE OF t1.id%TYPE; v_tab t_tab; BEGIN UPDATE t1 SET description = description RETURNING id BULK COLLECT INTO v_tab; FOR i IN v_tab.first .. l_tab.last LOOP DBMS_OUTPUT.put_line('UPDATE ID=' || l_tab(i)); END LOOP; COMMIT; END; /
UPDATE ID = 1
UPDATE ID = 2
UPDATE ID = 3
5.We can also use the RETURNING INTO clause in combination with bulk binds.
SET SERVEROUTPUT ON DECLARE TYPE t_desc_tab IS TABLE OF t1.description%TYPE; TYPE t_tab IS TABLE OF t1%ROWTYPE; l_desc_tab t_desc_tab := t_desc_tab('FIVE', 'SIX', 'SEVEN'); l_tab t_tab; BEGIN FORALL i IN l_desc_tab.first .. l_desc_tab.last INSERT INTO t1 VALUES (t1_seq.nextval, l_desc_tab(i)) RETURNING id, description BULK COLLECT INTO l_tab; FOR i IN l_tab.first .. l_tab.last LOOP DBMS_OUTPUT.put_line('INSERT ID=' || l_tab(i).id || ' DESC=' || l_tab(i).description); END LOOP; COMMIT; END; /
INSERT ID = 5 DESC =FIVE
INSERT ID = 6 DESC =SIX
INSERT ID = 7 DESC =SEVEN
6.This functionality is also available from dymanic SQL.
SET SERVEROUTPUT ON DECLARE TYPE t_tab IS TABLE OF t1.id%TYPE; l_tab t_tab; BEGIN EXECUTE IMMEDIATE 'UPDATE t1 SET description = description RETURNING id INTO :l_tab' RETURNING BULK COLLECT INTO l_tab; FOR i IN l_tab.first .. l_tab.last LOOP DBMS_OUTPUT.put_line('UPDATE ID=' || l_tab(i)); END LOOP; COMMIT; END; /
UPDATE ID = 1
UPDATE ID = 2
UPDATE ID = 3