Formateur SQL
Formater, minifier et échapper du SQL

Ce que fait pour vous un formateur SQL

Une requête copiée depuis un journal ou un outil tient souvent sur une seule longue ligne. De plus, vous ne pouvez ni la lire ni la relire. Il faut donc la couper en lignes, ajouter des retraits et mettre chaque clause à sa place.

Cet outil le fait dans une seule zone. D'abord, collez votre SQL. Ensuite, choisissez Formater, et le résultat apparaît pendant que vous tapez. Il met SELECT, FROM et WHERE sur leurs propres lignes et aligne les jointures et les conditions.

Par ailleurs, il minifie aussi le SQL, ce qui sert quand vous devez coller une requête dans du code ou dans un fichier de configuration. De plus, il échappe et retire l'échappement du texte, pour qu'un guillemet dans une valeur ne puisse pas casser votre instruction.

Tout s'exécute dans votre navigateur. Ainsi, votre SQL ne quitte jamais votre appareil. C'est important, car les requêtes contiennent souvent des noms de tables, des identifiants et parfois de vraies données.

Formater le SQL en lignes lisibles

D'abord, l'outil lit votre texte et le découpe en jetons. Un jeton est un mot, un nombre, une chaîne, un commentaire ou un symbole. D’ailleurs, comme il lit d'abord les chaînes et les commentaires, un mot-clé entre guillemets n'est jamais changé.

Ensuite, il dispose les jetons. Chaque clause principale commence sur une nouvelle ligne. La liste du SELECT reçoit une colonne par ligne quand elle en a plus d'une. Les jointures commencent une nouvelle ligne, et les AND et OR d'une condition s'alignent sous le WHERE.

Ainsi, les sous-requêtes se placent entre parenthèses et se décalent d'un niveau vers la droite. Ainsi, vous voyez où chacune commence et finit.

Pour plus de détails, voir : Wikipedia article on SQL.

Retraits, mots-clés et commentaires

Vous choisissez le retrait. Deux espaces, quatre espaces et tabulations sont proposés. Vous choisissez aussi la casse des mots-clés. En effet, les majuscules sont le style classique. Les minuscules sont populaires dans le code moderne. Un troisième choix laisse vos mots-clés comme vous les avez tapés.

De plus, les commentaires sont à l'abri. Un commentaire de ligne reste à la fin de sa ligne, et un commentaire de bloc reste là où vous l'avez mis. Si vous préférez un résultat propre, désactivez les commentaires.

Ainsi, l'outil ne change ni les noms, ni les valeurs, ni les chaînes. De plus, il déplace seulement des espaces et change la casse des mots-clés.

Minifier le SQL

Ensuite, il y a la minification, qui fait l'inverse. Elle retire les commentaires et les espaces superflus et garde une espace seulement là où deux mots se toucheraient.

Cela aide quand vous stockez une requête dans une chaîne. Cela aide aussi dans une URL ou un journal. Par ailleurs, le résultat est la même requête, en plus courte. Les notes sous le résultat montrent combien de caractères vous avez gagnés.

Échapper et retirer l'échappement d'un texte SQL

Un guillemet dans une valeur termine une chaîne trop tôt. C'est un bogue, et cela peut aussi être une faille de sécurité. Il faut donc échapper le guillemet avant de mettre le texte dans une instruction.

D’ailleurs, le SQL standard double le guillemet, qui devient deux guillemets simples. MySQL accepte aussi une barre oblique inverse devant le guillemet. L'outil fait les deux, et il peut ajouter les guillemets extérieurs pour vous.

Ensuite, le retrait de l'échappement fait l'inverse. Il retire les guillemets extérieurs et ramène à du texte normal chaque guillemet doublé ou séquence avec barre oblique inverse.

Échapper n'est pas une défense complète

Ainsi, l'échappement aide pour un texte ponctuel, comme une valeur dans un script. Pour une appli, utilisez plutôt des requêtes préparées avec des paramètres. Elles séparent les données et le code, donc aucun guillemet ne peut changer la requête.

Le formateur laisse tranquilles les paramètres, comme un nom avec deux-points ou un point d'interrogation. Ainsi, une requête préparée reste valide après le formatage.

Quel SQL il comprend

D'abord, l'outil travaille avec le noyau commun du SQL. Cela couvre SELECT, INSERT, UPDATE, DELETE, WITH et CREATE TABLE, ainsi que les jointures, les unions, les fonctions de fenêtre et CASE.

De plus, il lit les chaînes entre guillemets simples, les noms entre guillemets doubles, accents graves et crochets, et les deux types de commentaires. Ainsi, il convient au code MySQL, PostgreSQL, SQL Server, SQLite et Oracle.

Une syntaxe propre à un moteur peut paraître simple, mais elle reste valide. L'outil ne réécrit jamais une instruction, donc il ne peut pas la casser.

En effet, les procédures stockées et les longs scripts fonctionnent aussi. L'outil traite chaque point-virgule comme la fin d'une instruction, donc un script avec beaucoup d'instructions reste en ordre.

Sûr par conception

L'outil n'exécute jamais votre SQL et ne se connecte jamais à une base de données. Il lit seulement du texte et écrit seulement du texte, dans votre onglet.