database Formateur SQL star

Comment ça fonctionne

Une longue requête SQL écrite sur une seule ligne est difficile à parcourir pour en saisir la structure — où se termine la clause WHERE et où commence la GROUP BY, quel JOIN appartient à quelle table ? Cet outil prend du SQL brut et le découpe en lignes séparées à chaque limite de clause majeure : SELECT, FROM, WHERE, toute la famille JOIN (INNER JOIN, LEFT JOIN, RIGHT JOIN…), GROUP BY, ORDER BY, HAVING et UNION. Les conditions enchaînées avec AND/OR, ainsi que les conditions de jointure après ON, sont indentées d'un niveau sous la clause à laquelle elles appartiennent, et les mots-clés sont mis en majuscules en option pour la cohérence. Une requête comme select id,name from users where active=1 and role='admin' order by name devient un bloc où SELECT, FROM, WHERE et ORDER BY débutent chacun leur propre ligne, avec la condition AND indentée sous WHERE — la même information, simplement disposée comme elle le serait à la main lors d'une revue de code.

Cela compte le plus précisément là où c'est le plus difficile à faire à la main : des requêtes avec plusieurs tables jointes, une sous-requête enfouie dans une clause WHERE, ou une expression CASE à plusieurs branches. Une indentation cohérente est ce qui permet à un relecteur de repérer d'un coup d'œil une condition de jointure manquante ou une parenthèse mal placée, plutôt que de lire caractère par caractère.

Ce qu'il faut savoir

Ceci est un formateur, pas un validateur — il ne fait que réorganiser les espaces et les sauts de ligne autour d'un ensemble fixe de mots-clés qu'il reconnaît ; il n'analyse jamais la requête en un arbre syntaxique et ne l'exécute jamais contre une base de données. Un validateur véritablement conscient du dialecte nécessiterait un analyseur complet pour chaque variante SQL, car MySQL, PostgreSQL, SQL Server et SQLite divergent tous sur des détails comme l'échappement des identifiants, les fonctions de date, et même les instructions qui sont légales — une vérification superficielle côté navigateur prétendant valider tout cela ne produirait qu'une fausse confiance. Si le résultat formaté semble étrange, cela signifie généralement que l'entrée contenait déjà une faute de frappe ou une parenthèse non équilibrée ; l'outil formate autour plutôt que de le signaler.

Comme il n'agit que sur la mise en page du texte, il est sûr de l'exécuter sur des requêtes de production : les identifiants, les littéraux de chaîne, les valeurs numériques et les opérateurs ne sont jamais réécrits, ajoutés ou supprimés — seuls les espaces changent, plus la casse des mots-clés en option. Rien n'est envoyé où que ce soit ni exécuté ; la requête ne quitte jamais le navigateur.