Comment formater et réindenter du SQL

À quoi sert le formatage SQL ?

SQL Formatter sert à remettre en forme un texte SQL fourni par l’utilisateur : la sortie peut réindenter les éléments et écrire les mots-clés SQL en majuscules lorsque l’analyse et le formatage aboutissent. Il convient donc pour rendre une requête plus lisible avant une revue de code ou un partage, mais il ne sert pas à exécuter la requête, à se connecter à une base de données ou à vérifier ses résultats.

Comment formater une requête SQL

1. Saisissez ou collez le texte SQL dans le champ prévu à cet effet. L’entrée est facultative et sa valeur par défaut est vide. Le texte doit être une chaîne ; une valeur d’un autre type est refusée. Si vous utilisez une ancienne entrée appelée sql, elle peut être reprise lorsque l’entrée SQL principale est vide.

2. Choisissez le niveau d’indentation. La valeur par défaut est 2. Pour un texte SQL non vide, la valeur est convertie en entier : une conversion impossible, ou une valeur inférieure à 0 ou supérieure à 8, revient à 2. Les autres valeurs converties sont utilisées.

3. Vous pouvez laisser le dialecte sur sa valeur générique ou fournir une valeur de dialecte. Ce champ est accepté, mais le formatage décrit ici n’applique pas de règles de parsing ou de présentation propres à un dialecte.

4. Lancez le formatage, puis consultez le texte produit. En cas de réussite, les mots-clés SQL sont mis en majuscules et la structure est réindentée. Lorsque plusieurs instructions sont reconnues, elles sont réunies avec un point-virgule et un retour à la ligne, puis un point-virgule final est ajouté.

5. Si le résultat signale un échec, vérifiez d’abord que le texte contient une ou plusieurs instructions SQL reconnaissables et qu’il ne dépasse pas 1 000 000 octets UTF-8. Un échec peut aussi venir de l’indisponibilité de la bibliothèque d’analyse ou d’une exception pendant l’analyse ou le formatage.

Comment lire le résultat

La sortie attendue est un texte SQL réorganisé, et non un résultat de requête. Une réussite peut se reconnaître à la présence d’une indentation régulière et de mots-clés en majuscules. Si plusieurs instructions ont été analysées, vérifiez aussi leur séparation par un point-virgule et un retour à la ligne, ainsi que le point-virgule final.

Un texte composé uniquement d’espaces est accepté et produit un résultat formaté vide. Ce cas se produit avant la conversion du paramètre d’indentation ; il ne se comporte donc pas comme une entrée SQL non vide.

Le formatage ne prouve pas que la requête est valide pour une base de données donnée. Le champ de dialecte accepté ne suffit pas à établir un support ou une validation propres à ce dialecte, et le résultat peut dépendre de la capacité de l’analyseur à reconnaître les instructions fournies.

Exemple pratique

Une personne prépare une requête SQL compacte pour une revue de code et souhaite la rendre plus lisible sans l’exécuter.

Pour une requête compacte comme select id,name from clients where actif=1, choisissez une indentation de 4 et demandez le formatage ; examinez ensuite la structure réindentée et les mots-clés en majuscules.

Après une réussite, les mots-clés apparaissent en majuscules, les clauses sont réindentées et une instruction reconnue se termine par un point-virgule. Avec plusieurs instructions, elles sont séparées par un point-virgule et un retour à la ligne, avec un point-virgule final.

Limites

• Le champ de dialecte n’applique pas de règles dialectales dans le comportement décrit. Le paramètre d’accès réseau déclaré ne permet pas, à lui seul, de conclure à un environnement d’exécution particulier, à une conservation ou à une garantie de confidentialité.

Erreurs fréquentes

• Une entrée trop volumineuse ou qui ne contient aucune instruction SQL détectable peut échouer. Réduisez le texte à formater et vérifiez qu’il contient bien une instruction SQL avant de relancer le traitement.

Questions fréquentes

Que se passe-t-il si le champ SQL est vide ?

Oui, si l’entrée ne contient que des espaces : elle est acceptée et produit un résultat formaté vide. Pour une entrée non vide, un échec reste possible si aucune instruction n’est reconnue ou si une erreur survient pendant l’analyse ou le formatage.

Quelle indentation choisir ?

La valeur par défaut est 2. Pour une entrée non vide, une valeur impossible à convertir en entier ou située en dehors de 0 à 8 revient à 2 ; les autres valeurs converties sont utilisées.

Le choix du dialecte garantit-il une syntaxe adaptée à ma base de données ?

Le champ est accepté, mais le comportement décrit n’applique pas de règles de formatage propres à un dialecte. Il ne faut donc pas interpréter ce choix comme une validation dialectale.