Formateur SQL

Collez une requête SQL et récupérez-la indentée et répartie sur plusieurs lignes, avec des mots-clés comme SELECT, FROM et WHERE chacun sur leur propre ligne et une casse cohérente. Choisissez un dialecte pour que la syntaxe propre à chacun soit formatée correctement, et ajustez la casse des mots-clés ainsi que la largeur d’indentation selon le style de votre équipe.

Quels dialectes SQL sont pris en charge ?

Vous pouvez formater du SQL standard, MySQL, PostgreSQL, SQLite, T-SQL (SQL Server) ou BigQuery. Chaque dialecte a ses particularités, comme les identifiants entre accents graves de MySQL ou la syntaxe des tableaux et des struct de BigQuery, et choisir le bon permet au formateur de les analyser correctement au lieu de buter sur une syntaxe absente du SQL standard. En cas de doute sur le dialecte d’une requête, le SQL standard reste un choix sûr tant qu’elle ne s’appuie pas sur des fonctionnalités propres à un moteur.

Au-delà du dialecte, vous pouvez mettre les mots-clés en majuscules, en minuscules, ou les laisser tels quels, et régler l’indentation sur deux espaces, quatre espaces ou une tabulation. Mettre en majuscules une requête écrite en minuscules, par exemple, met en forme chaque SELECT, JOIN et GROUP BY sans toucher aux noms de colonnes ou de tables.

La requête quitte-t-elle mon navigateur ?

Non. Le formatage se fait entièrement côté client avec la bibliothèque sql-formatter, qui tourne en JavaScript et n’effectue aucune requête réseau. Rien de ce que vous collez n’est envoyé à un serveur, journalisé ou stocké : vous pouvez donc formater sans crainte une requête contenant de vrais noms de tables, des données clients ou des valeurs que vous ne voudriez pas coller dans un formulaire web quelconque.

Que se passe-t-il si le formateur n’arrive pas à analyser ma requête ?

Si le SQL ne s’analyse pas correctement dans le dialecte choisi, l’outil affiche une erreur plutôt que de deviner un résultat partiel. Cela signifie généralement que le mauvais dialecte est sélectionné, qu’il y a une vraie erreur de syntaxe, ou que la requête utilise une fonctionnalité que l’analyseur ne reconnaît pas (certaines extensions propres à un moteur ou des styles de commentaires inhabituels peuvent le dérouter). Changer de dialecte ou vérifier une virgule superflue ou une parenthèse non fermée près de l’endroit signalé suffit en général à corriger le problème.

Quand est-ce utile ?

Usages courants : nettoyer une requête sur une seule ligne copiée depuis le journal de débogage d’un ORM, uniformiser le formatage avant une revue de code, ou rendre lisible un script de migration minifié. Pour les conventions de style que le formatage seul ne résout pas, comme les noms de variables ou les commentaires, consultez le SQL Style Guide.