Un commentaire SQL est ignoré par le moteur lors de l'exécution : il sert uniquement à expliquer une requête pour la personne qui la relira plus tard, soi-même y compris.

-- démarre un commentaire de fin de ligne : tout ce qui suit -- jusqu'à la fin de la ligne est ignoré.

-- Affiche les produits d'hygiene dont le prix est raisonnable
SELECT nom, prix FROM produits
WHERE categorie = 'hygiene' AND prix < 500; -- exclut Dentifrice a 500

/* ... */ délimite un commentaire multi-lignes : tout ce qui se trouve entre /* et */ est ignoré, même sur plusieurs lignes.

/*
  Rapport mensuel : produits en catégorie hygiene
  avec un prix strictement inférieur a 500.
*/
SELECT nom, prix FROM produits
WHERE categorie = 'hygiene' AND prix < 500;

Bonne pratique à retenir : un commentaire utile explique le pourquoi d'une requête ou d'un choix (par exemple, pourquoi ce seuil de 500 $ précisément), pas ce que fait déjà clairement le code lui-même — un commentaire qui répète simplement WHERE prix < 500 en disant « filtre sur le prix » n'apporte rien de nouveau.

À retenir :

• -- commentaire commente jusqu'à la fin de la ligne ; /* commentaire */ commente un bloc, même sur plusieurs lignes.
• Un commentaire utile explique pourquoi, pas ce que le code fait déjà visiblement.

À vous de jouer : ajoutez un commentaire -- expliquant l'intention d'une requête WHERE vue à un chapitre précédent.