Cette page est le guide canonique pour formater et minifier du SQL dans Dev Tools Suite. Utilisez le SQL Formatter interactif ci-dessus pendant la lecture, ou sautez à une section ci-dessous. Tout l'analyse et le formatage s'exécutent dans votre navigateur via sql-formatter — requêtes, noms de schéma et données d'exemple ne sont jamais téléversés.

SQL Formatter embellit le SQL multiligne pour les humains et minifie le SQL pour le transport. Il met automatiquement les mots-clés en majuscules (SELECT, FROM, WHERE), applique une indentation par clause et respecte la grammaire spécifique au dialecte de la bibliothèque sql-formatter — le même moteur que de nombreuses extensions IDE et formateurs CLI.

Ce que vous obtenez

• Espace de travail double symétrique : requête SQL à gauche, sortie formatée ou minifiée à droite
• 13 analyseurs de dialecte groupés : Noyau relationnel, Cloud, Big data, Entreprise
• Modes Beautify et Minify avec auto-formatage en direct (débouncé) et bouton Process explicite
• Sélecteur de dialecte et case Strip comments dans l'en-tête du panneau — pas de ligne d'options supplémentaire
• Sortie formatée repliable pour grands arbres SELECT (mode Beautify)
• Erreurs d'analyse avec indications ligne/colonne quand l'analyseur ne peut pas lire l'entrée
• Partage d'URL optionnel : ?mode=minify&dialect=postgresql persiste mode et dialecte

Utilisez cet outil lorsque

• Vous collez du SQL ad hoc d'un log, outil BI ou ORM et avez besoin d'indentation lisible avant revue
• Vous intégrez du SQL dans du code applicatif et voulez une chaîne minifiée sur une ligne
• Vous travaillez avec PostgreSQL, Snowflake, BigQuery, Spark ou Oracle et avez besoin que l'analyseur reconnaisse les mots-clés du dialecte
• Vous voulez retirer commentaires de bloc et de ligne avant commit ou envoi

N'attendez pas

• Validation sémantique — un formatage réussi ne garantit pas l'exécution sur votre serveur
• Planification automatique, lint de performance ou réécritures conscientes du schéma
• Préservation parfaite de chaque extension exotique non couverte par le dialecte sélectionné
• EXPLAIN ou exécution côté serveur — c'est uniquement un outil de mise en page et d'espaces

Les contrôles sont dans l'en-tête du panneau SQL QUERY pour que les éditeurs entrée/sortie gardent la même hauteur. Pas de ligne d'options séparée sous la barre d'outils.

Raccourcis clavier

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — Effacer l'espace de travail

Choisissez toujours le dialecte correspondant à l'environnement d'exécution. L'analyseur utilise des listes de mots-clés, noms de fonctions et règles de commentaires distinctes par dialecte. Standard SQL est un défaut sûr pour des extraits ANSI génériques.

Cassandra CQL n'est pas pris en charge — il ne fait pas partie du jeu de dialectes sql-formatter. Utilisez un formateur CQL dédié pour Cassandra.

Beautify et Minify partagent le même sélecteur de dialecte et la case Strip comments mais produisent des formes de sortie différentes.

Exemple

Entrée : select id, name from users where active = 1 — Beautify produit des lignes indentées avec SELECT / FROM / WHERE en majuscules. Minify avec Strip désactivé produit une ligne : select id, name from users where active = 1.

1. Ouvrez SQL Formatter depuis la barre latérale sous Formatters.
2. Collez du SQL dans l'éditeur gauche, téléversez un fichier .sql depuis la barre de session ou glissez-déposez sur l'état vide.
3. Choisissez le dialecte correspondant à votre base (ex. snowflake pour une feuille Snowflake).
4. Cochez optionnellement Strip comments si l'entrée contient des annotations -- ou /* */ indésirables.
5. Sélectionnez Beautify pour du SQL lisible ou Minify pour une ligne compacte.
6. Vérifiez la sortie à droite. Corrigez toute bannière d'erreur d'analyse — cliquez pour fermer après édition.
7. Copiez, téléchargez ou échangez la sortie vers l'entrée pour un autre passage.
8. Partagez un lien ?dialect=bigquery&mode=minify pour que les collaborateurs ouvrent les mêmes réglages.

Les fichiers de migration Flyway, Liquibase et ORM sont plus faciles à revoir quand listes SELECT, blocs JOIN et clauses WHERE sont sur des lignes cohérentes.

Flux de travail

1. Réglez le dialecte sur postgresql, transactsql, mysql ou sqlite selon la cible de migration.
2. Collez le SQL de migration brut d'un diff généré ou sortie ORM.
3. Beautify avec Strip désactivé si les commentaires en ligne documentent l'intention.
4. Copiez le SQL formaté dans le fichier de migration avant d'ouvrir la PR.

Astuce

Le formatage ne valide pas contre votre schéma en direct. Exécutez les migrations sur une base de staging après changements cosmétiques.

Les ingénieurs analytics copient souvent du SQL depuis des consoles Snowflake, BigQuery ou Redshift avec casse incohérente et lignes repliées.

Snowflake / BigQuery / Redshift

• Sélectionnez snowflake, bigquery ou redshift avant Beautify pour que les fonctions d'entrepôt s'analysent correctement.
• Utilisez Strip comments en exportant depuis un notebook avec notes de session --.
• Pour de larges listes SELECT, utilisez les contrôles de pliage (Expand all / Collapse all) après Beautify.

Spark / Trino / Hive

• Choisissez spark pour notebooks Databricks et pipelines Spark SQL.
• Choisissez trino pour requêtes fédérées compatibles Presto entre catalogues.
• Choisissez hive pour scripts HiveQL hérités — la couverture suit les règles dialecte Hive de sql-formatter.

Le code applicatif stocke souvent le SQL comme chaîne modèle. Minify réduit octets et échappements pour une ligne dans JavaScript, Python ou Go.

1. Collez la version lisible du SQL dans le panneau d'entrée.
2. Activez Strip comments si des notes de débogage restent dans la requête.
3. Passez en mode Minify.
4. Copiez la sortie une ligne dans votre littéral de chaîne (attention aux guillemets selon le langage).

Si vous avez besoin de SQL lisible en source mais compact à l'exécution, gardez la version embellie en docs et minifiez seulement l'artefact de build.

Normalisez le SQL avant revue pour que les diffs portent sur la logique, pas le bruit d'espaces.

• Embellissez les deux côtés d'une comparaison quand un collègue colle du SQL sur une ligne dans un ticket.
• Utilisez des mots-clés en majuscules comme style cohérent — le formateur l'applique automatiquement en Beautify.
• Transférez la sortie vers Text Diff après formatage de deux versions pour un diff sémantique du texte de requête.

La case Strip comments s'applique à Beautify et Minify. Quand activée, l'outil retire les commentaires avant formatage avec des règles adaptées au dialecte où implémentées.

Quand Strip est désactivé (Minify)

Minify réduit encore les espaces à une ligne mais garde le texte des commentaires. Utilisez quand les commentaires doivent partir avec la requête.

Quand l'analyseur échoue, une bannière rouge affiche Parse error avec numéros de ligne et colonne. L'éditeur d'entrée surligne la ligne d'erreur quand disponible.

Correctifs courants

1. Mauvais dialecte — passez au moteur réellement utilisé (ex. plsql pour packages Oracle, pas Standard SQL).
2. Chaîne ou parenthèse non fermée — équilibrez guillemets et parenthèses près de la ligne signalée.
3. Virgule finale ou clause incomplète — terminez listes SELECT et CTE avant formatage.
4. Contenu non-SQL collé — retirez enveloppes shell ou JSON autour de la requête.
5. Syntaxe spécifique au dialecte en mode générique — essayez le dialecte fournisseur ou simplifiez extensions non supportées.

Si une requête valide échoue encore, l'analyseur sql-formatter peut ne pas couvrir cette variante. Signalez en amont ou formatez manuellement un sous-ensemble simplifié.

SQL Formatter s'exécute à 100 % dans votre navigateur. La bibliothèque sql-formatter est chargée dynamiquement ; le formatage s'exécute sur le thread principal en JavaScript.

• Aucun texte de requête n'est envoyé aux serveurs Dev Tools Suite
• Entrée, sortie, dialecte et préférence Strip comments peuvent persister dans localStorage sur votre appareil
• Les paramètres d'URL (?dialect=, ?mode=) reflètent seulement les réglages — pas le corps SQL
• Effacez l'espace de travail (Ctrl/Cmd+L) après travail avec données de production ou PII

• Faites correspondre le dialecte à l'environnement d'exécution avant Beautify — succès du formatage ≠ succès à l'exécution
• Beautify pour humains, Minify pour machines
• Gardez Strip désactivé quand les commentaires documentent des règles métier ; activez pour exports et chaînes intégrées
• Vérifiez la sortie minifiée sur une base de staging avec guillemets dollar ou littéraux exotiques
• Utilisez historique de session et upload de fichier pour grands scripts plutôt que coller dans des apps de chat qui altèrent les guillemets
• Combinez avec Text Diff en comparant deux versions formatées de la même requête de rapport