VALUES

Syntaxe

Paramètres

Description

Cette fonction permet d'indiquer des valeurs de colonnes dans une instruction INSERT.

Remarques

• Dans une instruction INSERT ... ON DUPLICATE KEY UPDATE, vous pouvez utiliser la fonction «VALUES(col_name)» dans la clause UPDATE pour faire référence aux valeurs de colonne de la partie INSERT de l'instruction. En d'autres termes, «VALUES(col_name)» dans la clause UPDATE fait référence à la valeur de col_name étant insérée si aucun conflit de clef en double ne s'était produit. Cette fonction est particulièrement utile dans les insertions à plusieurs lignes.
• La fonction VALUES() n'a de sens que dans les instructions INSERT ... ON DUPLICATE KEY UPDATE et renvoie NULL sinon.
• Dans MariaDB 10.3.3, la fonction VALUES() a été renommée VALUE(), car elle est incompatible avec la syntaxe standard des constructeurs de valeurs de table, mise en oeuvre dans MariaDB 10.3.3.
• La fonction VALUES() peut toujours être utilisée même à partir de MariaDB 10.3.3, mais uniquement dans les instructions INSERT ... ON DUPLICATE KEY UPDATE; c'est une erreur de syntaxe sinon.