Commentaires en SQL

Introduction aux Commentaires

Dans le monde de la programmation, un commentaire est un morceau de texte présent dans le code qui n’est pas interprété ou exécuté. Les commentaires servent principalement à fournir des précisions pour faciliter la compréhension du code, ou à neutraliser certaines instructions SQL qui ne doivent pas être exécutées.

Commentaires sur une ligne

Les commentaires d'une seule ligne en SQL commencent par --. Tout texte placé entre -- et la fin de la ligne sera ignoré par le moteur SQL. Voici un exemple d'utilisation d'un commentaire sur une ligne :

-- Sélectionner tous les clients :
SELECT * FROM customers;

Commentaires sur plusieurs lignes

Les commentaires sur plusieurs lignes débutent par /* et se terminent par */. Tous les textes situés entre ces deux délimiteurs seront également ignorés. Par exemple :

/* Sélectionner toutes les informations de la table clients */
SELECT * FROM customers;

On peut aussi utiliser un commentaire multi-lignes pour ignorer plusieurs instructions à la fois :

/* SELECT * FROM customers;
   SELECT * FROM products; */
SELECT * FROM orders;

Commentaire Partiel

Pour ignorer une partie d'une instruction, il est également possible d'utiliser les commentaires multi-lignes. Voici un exemple où une partie de la ligne est commentée :

SELECT id, customer_name, /* ville, */ country FROM customers;