Data Manipulation Language (DML)

4.

UPDATE T1

SET F2 = F2 * 10

RETURNING OLD.F2, NEW.F2;

UPDATE OR INSERT Statement

Adriano dos Santos Fernandes

(v.2.1) This syntax has been introduced to enable a record to be either updated or inserted, according to whether or not it already exists (checked with IS NOT DISTINCT). The statement is available in both DSQL and PSQL.

Syntax Pattern

UPDATE OR INSERT INTO <table or view> [(<column_list>)] VALUES (<value_list>)

[MATCHING <column_list>]

[RETURNING <column_list> [INTO <variable_list>]]

Examples

1.

UPDATE OR INSERT INTO T1 (F1, F2)

VALUES (:F1, :F2);

2.

UPDATE OR INSERT INTO EMPLOYEE (ID, NAME)

VALUES (:ID, :NAME)

RETURNING ID;

3.

UPDATE OR INSERT INTO T1 (F1, F2)

VALUES (:F1, :F2)

MATCHING (F1);

4.

UPDATE OR INSERT INTO EMPLOYEE (ID, NAME)

VALUES (:ID, :NAME)

RETURNING OLD.NAME;

Usage Notes

1.When MATCHING is omitted, the existence of a primary key is required.

2.INSERT and UPDATE permissions are needed on <table or view>.

46