Firebird 2.1 Language Reference Update

Example:
Notes:
Restrictions
DML statements
• No column may appear more than once in the update/insert column list.
• If the table has no PK, the MATCHING clause becomes mandatory.
• The “INTO ” subclause is only available in PSQL.
• When values are returned into the context variable NEW, this name must not be preceded by
a colon (“:”).
update or insert into Cows (Name, Number, Location)
values ('Suzy Creamcheese', 3278823, 'Green Pastures')
matching (Number)
returning rec_id into :id;
• Matches are determined with IS NOT DISTINCT, not with the “=” operator. This means that one NULL matches
another.
• The optional RETURNING clause:
- ...may contain any or all columns of the target table, regardless if they were mentioned earlier in the
statement, but also other expressions.
- ...may contain OLD and NEW qualifiers for field names; by default, the new field value is returned.
- ...returns field values as they are after the BEFORE triggers have run, but before any AFTER triggers.
88