Le SQL est souvent écrit rapidement puis relu à plusieurs reprises sous pression. Une mise en forme cohérente est l’un des moyens les plus simples de rendre les requêtes faciles à relire, déboguer et partager. Ce guide explique l’intérêt de la mise en forme, les conventions de casse des mots-clés et les cas où il est utile de réduire une requête.
Des requêtes lisibles facilitent les revues de code
Une requête condensée sur une seule ligne masque sa structure. Lorsque chaque clause — SELECT, FROM, chaque JOIN, WHERE et GROUP BY — commence sur sa propre ligne, le réviseur voit immédiatement quelles tables sont jointes, sur quelles clés et quels filtres s’appliquent. L’indentation de la liste SELECT et des conditions de jointure ajoute un second niveau de structure : les colonnes se parcourent sans devoir analyser toute l’instruction. Les oublis sont moins fréquents (une condition de jointure manquante est évidente si ON apparaît seul sur une ligne indentée) et les revues sont plus rapides. Le formateur est conçu pour modifier uniquement les espaces et la casse des mots-clés reconnus, mais il traite le texte au mieux et n’est pas un analyseur SQL. Relisez le résultat et validez les requêtes importantes avec vos outils de base de données.
Conventions de casse des mots-clés
La convention de longue date consiste à écrire les mots-clés SQL en MAJUSCULES et les identifiants (tables, colonnes, alias) en minuscules ou en casse mixte. Ce contraste fait ressortir la structure du langage par rapport au schéma. Certaines équipes préfèrent tout écrire en minuscules, d’autres mettent une majuscule initiale aux mots-clés. Il n’existe pas de choix universellement correct : l’essentiel est de rester cohérent dans tout le code, d’où l’intérêt d’un formateur appliquant la même règle partout. Cet outil ne modifie que la casse des mots-clés reconnus ; les noms de tables et de colonnes gardent leur casse et le contenu des chaînes ou des commentaires n’est jamais altéré.
Quand réduire une requête
La réduction, qui ramène une requête à une seule ligne, est l’inverse de la mise en forme et répond à certains besoins. Les sauts de ligne gênent lorsqu’une requête doit être intégrée sous forme de chaîne constante au code source, à une valeur de configuration JSON ou YAML, ou à une commande shell. Le mode Réduire supprime les espaces de mise en forme tout en conservant le contenu des chaînes littérales. Il supprime également les commentaires, car un commentaire sur une ligne (--) neutraliserait tout le texte qui suit. Relisez le résultat et validez les requêtes importantes avec vos outils de base de données, sans supposer que chaque entrée conserve nécessairement le même sens. Pour retrouver une version lisible, collez la requête réduite dans l’onglet Mise en forme.
Un formateur ne valide pas les requêtes
Il est important de bien comprendre les limites de l’outil. Il met en forme du texte : il ne se connecte pas à une base de données, n’exécute pas la requête et ne vérifie pas qu’elle est valide en SQL. Si vous collez une requête qu’il ne peut pas analyser entièrement, il applique tout de même des espacements au mieux et signale une mise en forme partielle au lieu d’échouer. Cela permet une utilisation quotidienne rapide et sûre, mais vous devez toujours exécuter la requête sur une vraie base de données (ou avec un linter) pour en confirmer la validité. La mise en forme est une première étape simple pour écrire du SQL propre, pas une garantie de fonctionnement.