FirebirdSQL logo

RETURNING

L'instruction UPDATE, peut inclure RETURNING pour retourner les valeurs des enregistrements mis à jour. L'instruction RETURNING peut inclure n'importe quelles colonnes, pas nécessairement seulement celles qui sont mises à jour.

Les valeurs retournées contiennent les changements effectués dans les déclencheurs BEFORE UPDATE mais pas dans les déclencheurs AFTER UPDATE. Les expressions OLD.fieldname et NEW.fieldname peuvent être utilisées comme noms de colonnes. Si OLD. ou NEW. n'est pas spécifié, les nouvelles valeurs de colonnes NEW. 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 DML, l'instruction UPDATE avec la clause RETURNING renvoie un curseur (avant Firebird 5.0, elle ne pouvait renvoyer qu'un seul enregistrement). Actuellement, les instructions avec la clause RETURNING ne peuvent pas être appliquées avec la clause FOR pour boucler sur un curseur en PSQL. Ce comportement peut être modifié dans les futures versions de Firebird. Si les enregistrements n'ont pas été mis à jour par l'instruction, les valeurs de retour contiennent NULL.