Available in versions: Dev (3.19) | Latest (3.18) | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12 | 3.11 | 3.10 | 3.9
UPDATE .. RETURNING
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
Various dialect support a RETURNING clause or something similar on their UPDATE statements, similar as the RETURNING clause in INSERT statements. This is useful to fetch trigger-generated values in one go. An example is given here:
-- Fetch a trigger-generated value UPDATE BOOK SET TITLE = 'Animal Farm' WHERE ID = 5 RETURNING TITLE
String title = create.update(BOOK)
.set(BOOK.TITLE, "Animal Farm")
.where(BOOK.ID.eq(5))
.returning(BOOK.TITLE)
.fetchOne().getValue(BOOK.TITLE);
Dialect support
This example using jOOQ:
update(BOOK).set(BOOK.TITLE, "New Title").returningResult(BOOK.ID)
Translates to the following dialect specific expressions:
-- AURORA_POSTGRES, COCKROACHDB, POSTGRES, SQLITE, YUGABYTEDB
UPDATE BOOK
SET
TITLE = 'New Title'
RETURNING BOOK.ID
-- DB2, H2
SELECT ID
FROM FINAL TABLE (
UPDATE BOOK
SET
BOOK.TITLE = 'New Title'
) BOOK
-- FIREBIRD
UPDATE BOOK
SET
BOOK.TITLE = 'New Title'
RETURNING BOOK.ID
-- MARIADB
INSERT INTO BOOK (
ID,
AUTHOR_ID,
TITLE,
PUBLISHED_IN,
LANGUAGE_ID
)
SELECT
BOOK.ID,
BOOK.AUTHOR_ID,
BOOK.TITLE,
BOOK.PUBLISHED_IN,
BOOK.LANGUAGE_ID
FROM BOOK
ON DUPLICATE KEY UPDATE
BOOK.TITLE = 'New Title'
RETURNING ID
-- ORACLE
DECLARE
o0 DBMS_SQL.NUMBER_TABLE;
c0 sys_refcursor;
BEGIN
UPDATE BOOK
SET
BOOK.TITLE = 'New Title'
RETURNING BOOK.ID
BULK COLLECT INTO o0;
? := SQL%ROWCOUNT;
OPEN c0 FOR SELECT * FROM TABLE(o0);
? := c0;
END;
-- SQLSERVER
UPDATE BOOK
SET
BOOK.TITLE = 'New Title'
OUTPUT inserted.ID
-- ACCESS, ASE, AURORA_MYSQL, BIGQUERY, DERBY, DUCKDB, EXASOL, HANA, HSQLDB, INFORMIX, MEMSQL, MYSQL, REDSHIFT, SNOWFLAKE,
-- SQLDATAWAREHOUSE, SYBASE, TERADATA, TRINO, VERTICA
/* UNSUPPORTED */
(These are currently generated with jOOQ 3.19, see #10141), or translate your own on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!