Table des matières
Manuel de référence MySQL 8.0 - Structure du langage
Literal Values
Schema Object Names
Keywords and Reserved Words
User-Defined Variables
Expressions
Query Attributes
Commentaires
MySQL Server prend en charge trois styles de commentaires :
-
Depuis un caractère # jusqu'à la fin de la ligne :
SELECT * FROM MaTable; # Commentaire jusqu'à la fin de la ligne
-
Depuis un double tiret (--) jusqu'à la fin de la ligne :
SELECT * FROM MaTable; -- Commentaire jusqu'à la fin de la ligne
Le double tiret (--) doit être suivi d'au moins un espace ou un caractère de contrôle (comme un espace, une tabulation, une nouvelle ligne, etc.)
-
Depuis une séquence /* jusqu'à la séquence */ qui suit :
/* Commentaire sur plusieurs lignes */
Cette syntaxe permet un commentaire sur plusieurs lignes car les séquences de début et de fin n'ont pas besoin d'être sur la même ligne.
Évitez les commentaires imbriqués, obsolètes.
Variantes
-
/*! MySQL-specific code */
Ce code est exécuté par MySQL Server mais pas par un autre serveur SQL. Exemple :
SELECT /*! STRAIGHT_JOIN */ col1 FROM table1,table2 WHERE ...
MySQL Server reconnaît le mot clé STRAIGHT_JOIN mais pas les autres serveurs
-
Si vous ajoutez un numéro de version après le caractère !, la syntaxe dans le commentaire n'est exécutée que si la version MySQL est supérieure ou égale au numéro de version spécifié. Exemple :
CREATE TABLE t1(a INT, KEY (a)) /*!50110 KEY_BLOCK_SIZE=1024 */;
Le mot-clé KEY_BLOCK_SIZE n'est exécuté que par MySQL server 5.1.10 ou supérieur
-
/*+ (avec un +) Exemple :
SELECT /*+ BKA(t1) */ FROM ... ;
spécifie des conseils d'optimisation