Formateur SQL

Ce que fait l’outil

Le formateur SQL transforme une longue requête sur une seule ligne en une requête lisible et indentée de façon cohérente. Chaque clause (SELECT, FROM, WHERE, GROUP BY, ORDER BY) commence sur sa propre ligne, les colonnes sélectionnées et les conditions sont listées une par ligne, les jointures s’alignent sous la table qu’elles joignent, et les sous-requêtes sont indentées à l’intérieur de leurs parenthèses.

Un SQL formaté est plus facile à relire dans une pull request, à déboguer quand une requête renvoie les mauvaises lignes, et à coller dans de la documentation. Il aide aussi quand vous copiez une requête depuis un log d’ORM ou un message d’erreur d’application, où tout tient sur une ligne.

Mode d’emploi

1. Collez une ou plusieurs instructions SQL dans la zone Entrée, déposez-y un fichier .sql ou cliquez sur Exemple.
2. Choisissez le Dialecte de votre base de données.
3. Choisissez des Mots-clés en MAJUSCULES, en minuscules ou tels que saisis. Les noms de fonctions comme COUNT suivent le même réglage.
4. Choisissez 2 espaces, 4 espaces ou des tabulations pour l’Indentation.
5. Copiez le résultat ou téléchargez-le en fichier .sql. Raccourcis : Ctrl/Cmd+Enter formate, Ctrl/Cmd+Shift+C copie.

Plusieurs instructions séparées par des points-virgules sont séparées par une ligne vide. Les commentaires restent à leur place.

Exemple

select u.id, count(o.id) as orders from users u left join orders o on o.user_id = u.id group by u.id

devient

SELECT
  u.id,
  COUNT(o.id) AS orders
FROM
  users u
  LEFT JOIN orders o ON o.user_id = u.id
GROUP BY
  u.id

Astuces

Les mots-clés en majuscules font ressortir les clauses par rapport aux noms de tables et de colonnes : c’est la convention d’équipe la plus courante. Si votre équipe écrit le SQL en minuscules, choisissez minuscules et toute la requête suivra. Si le formateur signale un token inattendu, vérifiez que le dialecte est le bon : par exemple, les noms entre backticks sont valides en MySQL mais pas en SQL standard.