RETURNING

La clause RETURNING peut contenir toutes les colonnes spécifiées dans la déclaration ou d'autres colonnes et expressions. Les valeurs de retour contiennent tous les changements effectués dans les déclencheurs BEFORE mais pas dans les déclencheurs AFTER. Les expressions OLD.fieldname et NEW.fieldname peuvent être utilisées comme valeurs de retour. Pour les noms de colonnes normaux, les nouvelles valeurs sont retournées.

Vous pouvez spécifier un astérisque (*) au lieu d'une liste de colonnes. Dans ce cas, toutes les valeurs des colonnes de la table seront retournées. L'astérisque peut être utilisé avec les spécificateurs NEW ou OLD.

Note

En DSQL, une déclaration avec RETURNING ne retourne toujours qu'une seule chaîne de caractères. Si une clause RETURNING est présente et que plus d'une chaîne de caractères correspondante est trouvée, un message d'erreur est émis. Ce comportement peut être modifié dans les versions ultérieures de Firebird.

Example 1. Utilisation de la clause "RETURNING" dans une instruction "UPDATE OR INSERT".
UPDATE OR INSERT INTO Cows (Name, Number, Location)
VALUES ('Suzy Creamcheese', 3278823, 'Green Pastures')
MATCHING (Number)
RETURNING rec_id
INTO :id;