Diese Seite ist der kanonische Leitfaden zum Formatieren und Minifizieren von SQL in Dev Tools Suite. Nutzen Sie den interaktiven SQL Formatter oben beim Lesen oder springen Sie zu einem Abschnitt unten. Parsing und Formatierung laufen im Browser via sql-formatter — Abfragen, Schemanamen und Beispieldaten werden nie hochgeladen.

SQL Formatter verschönert mehrzeiliges SQL für Menschen und minifiziert SQL für den Transport. Er setzt Schlüsselwörter automatisch in Großbuchstaben (SELECT, FROM, WHERE), wendet klauselbewusste Einrückung an und respektiert dialektspezifische Grammatik der sql-formatter-Bibliothek — dieselbe Engine wie viele IDE-Erweiterungen und CLI-Formatter.

Was Sie erhalten

• Symmetrischer Dual-Pane-Arbeitsbereich: SQL-Eingabe links, formatierte oder minifizierte Ausgabe rechts
• 13 Dialekt-Parser gruppiert als Kern relational, Cloud-Warehouses, Big Data und Enterprise
• Beautify- und Minify-Modi mit Live-Auto-Format (debounced) und explizitem Process-Button
• Dialekt-Auswahl und Strip-comments-Kontrollkästchen in der Panel-Kopfzeile — keine Extra-Zeile
• Einklappbare formatierte Ausgabe für große SELECT-Bäume (Beautify-Modus)
• Parse-Fehler mit Zeilen- und Spaltenhinweisen, wenn der Dialekt-Parser die Eingabe nicht lesen kann
• Optionales URL-Sharing: ?mode=minify&dialect=postgresql speichert Modus und Dialekt

Dieses Tool verwenden, wenn

• Sie fügen Ad-hoc-SQL aus Log, BI-Tool oder ORM ein und brauchen lesbare Einrückung vor dem Review
• Sie betten SQL in Anwendungscode ein und wollen einen einzeiligen minifizierten String
• Sie arbeiten mit PostgreSQL, Snowflake, BigQuery, Spark oder Oracle und brauchen Dialekt-Schlüsselwörter im Parser
• Sie wollen Block- und Zeilenkommentare vor Commit oder Versand entfernen

Nicht erwarten

• Semantische Validierung — Formatierungserfolg bedeutet nicht, dass die Abfrage auf Ihrem Server läuft
• Automatische Abfrageplanung, Performance-Lint oder schema-bewusste Umschreibungen
• Perfekte Erhaltung jeder exotischen Vendor-Erweiterung außerhalb des gewählten Dialekts
• Serverseitiges EXPLAIN oder Ausführung — nur Layout- und Whitespace-Tool

Steuerelemente sitzen in der SQL-QUERY-Panel-Kopfzeile, damit Eingabe- und Ausgabe-Editoren gleich hoch bleiben. Keine separate Optionszeile unter der Toolbar.

Tastenkürzel

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — Arbeitsbereich leeren

Wählen Sie immer den Dialekt, der zur Ausführungsumgebung passt. Der Parser nutzt unterschiedliche Schlüsselwortlisten, Funktionsnamen und Kommentarregeln pro Dialekt. Standard SQL ist ein sicherer Default für generische ANSI-Snippets.

Cassandra CQL wird nicht unterstützt — nicht Teil des sql-formatter-Dialekt-Sets. Nutzen Sie einen CQL-spezifischen Formatter für Cassandra.

Beautify und Minify teilen Dialekt-Auswahl und Strip-comments-Kontrollkästchen, erzeugen aber unterschiedliche Ausgabeformen.

Beispiel

Eingabe: select id, name from users where active = 1 — Beautify liefert eingerückte Zeilen mit SELECT / FROM / WHERE in Großbuchstaben. Minify mit Strip aus liefert eine Zeile: select id, name from users where active = 1.

1. Öffnen Sie SQL Formatter in der Seitenleiste unter Formatters.
2. Fügen Sie SQL links ein, laden Sie eine .sql-Datei von der Session-Toolbar oder ziehen Sie eine Datei auf den leeren Zustand.
3. Wählen Sie den Dialekt Ihrer Datenbank (z. B. snowflake für Snowflake-Arbeitsblatt-Abfragen).
4. Optional Strip comments aktivieren, wenn -- oder /* */-Anmerkungen in der Ausgabe unerwünscht sind.
5. Wählen Sie Beautify für lesbares SQL oder Minify für eine kompakte Zeile.
6. Prüfen Sie die Ausgabe rechts. Beheben Sie Parse-Fehler-Banner — nach Bearbeitung zum Schließen klicken.
7. Kopieren, herunterladen oder Ausgabe zurück zur Eingabe tauschen für einen weiteren Durchlauf.
8. Teilen Sie einen Link mit ?dialect=bigquery&mode=minify für dieselben Einstellungen.

Flyway-, Liquibase- und ORM-Migrationsdateien lassen sich leichter prüfen, wenn SELECT-Listen, JOIN-Blöcke und WHERE-Klauseln auf konsistente Zeilen umbrechen.

Workflow

1. Dialekt auf postgresql, transactsql, mysql oder sqlite passend zum Migrationsziel setzen.
2. Rohes Migrations-SQL aus generiertem Diff oder ORM-Ausgabe einfügen.
3. Beautify mit Strip aus, wenn Inline-Kommentare die Absicht dokumentieren.
4. Formatiertes SQL vor dem PR zurück in die Migrationsdatei kopieren.

Tipp

Formatierung validiert nicht gegen Ihr Live-Schema. Führen Sie Migrationen nach kosmetischen Änderungen auf Staging aus.

Analytics-Ingenieure kopieren oft SQL aus Snowflake-, BigQuery- oder Redshift-Konsolen mit inkonsistenter Schreibweise und zusammengefallenen Zeilen.

Snowflake / BigQuery / Redshift

• snowflake, bigquery oder redshift vor Beautify wählen, damit Warehouse-Funktionen korrekt parsen.
• Strip comments beim Export aus Notebooks mit ---Sitzungsnotizen nutzen.
• Bei sehr breiten SELECT-Listen nach Beautify Fold-Steuerungen (Expand all / Collapse all) nutzen.

Spark / Trino / Hive

• spark für Databricks-Notebooks und Spark-SQL-Pipelines wählen.
• trino für Presto-kompatible föderierte Abfragen über Kataloge wählen.
• hive für Legacy-HiveQL-Skripte — Parser-Abdeckung folgt sql-formatter-Hive-Regeln.

Anwendungscode speichert SQL oft als Template-String. Minify reduziert Bytes und Escapes für eine Zeile in JavaScript, Python oder Go.

1. Lesbare SQL-Version ins Eingabepanel einfügen.
2. Strip comments aktivieren, wenn Entwickler Debug-Notizen in der Abfrage ließen.
3. Auf Minify-Modus wechseln.
4. Einzeilige Ausgabe in String-Literal kopieren (Anführungszeichen-Escaping beachten).

Bei lesbarem SQL im Quellcode aber kompaktem Laufzeit-SQL: beautified Version in Docs behalten, nur Build-Artefakt minifizieren.

SQL vor dem Review normalisieren, damit Diffs Logik statt Whitespace-Rauschen zeigen.

• Beide Seiten einer Vergleichsansicht beautify, wenn Kollegen Einzeiler-SQL in Tickets einfügen.
• Großbuchstaben-Schlüsselwörter als konsistenten Stil nutzen — Formatter wendet das in Beautify automatisch an.
• Ausgabe nach Formatierung zweier Versionen an Text Diff weiterleiten für semantischen Abfrage-Diff.

Strip comments gilt für Beautify und Minify. Wenn aktiv, entfernt das Tool Kommentare vor dem Formatieren mit dialektbewussten Regeln, wo implementiert.

Wenn Strip aus ist (Minify)

Minify reduziert Whitespace weiter auf eine Zeile, behält aber Kommentartext. Nutzen wenn Kommentare mit der Abfrage mitgehen sollen.

Bei Parser-Fehler zeigt ein rotes Banner Parse error mit Zeilen- und Spaltennummern. Der Eingabe-Editor hebt die Fehlerzeile hervor, wenn verfügbar.

Häufige Behebungen

1. Falscher Dialekt — zum tatsächlich genutzten Engine wechseln (z. B. plsql für Oracle-Pakete, nicht Standard SQL).
2. Nicht geschlossene Zeichenkette oder Klammer — Anführungszeichen und Klammern nahe der gemeldeten Zeile ausgleichen.
3. Nachgestelltes Komma oder unvollständige Klausel — SELECT-Listen und CTEs vor Format abschließen.
4. Nicht-SQL eingefügt — Shell- oder JSON-Hüllen um die Abfrage entfernen.
5. Dialektspezifische Syntax im generischen Modus — Vendor-Dialekt probieren oder nicht unterstützte Erweiterungen vereinfachen.

Wenn eine gültige Abfrage weiter fehlschlägt, deckt der sql-formatter-Parser diese Syntaxvariante ggf. nicht ab. Upstream melden oder vereinfachte Teilmenge manuell formatieren.

SQL Formatter läuft zu 100 % im Browser. Die sql-formatter-Bibliothek wird dynamisch geladen; Formatierung läuft im Hauptthread in JavaScript.

• Kein Abfragetext wird an Dev Tools Suite-Server gesendet
• Eingabe, Ausgabe, Dialekt und Strip-comments-Präferenz können in localStorage auf Ihrem Gerät persistieren
• URL-Parameter (?dialect=, ?mode=) spiegeln nur Einstellungen — nicht Ihren SQL-Body
• Arbeitsbereich leeren (Ctrl/Cmd+L) nach Arbeit mit Produktionsdaten oder PII

• Dialekt vor Beautify an Ausführungsumgebung anpassen — Formatierungserfolg ≠ Laufzeiterfolg
• Beautify für Menschen, Minify für Maschinen
• Strip aus lassen, wenn Kommentare Geschäftsregeln dokumentieren; an für Exporte und eingebettete Strings
• Minifizierte Ausgabe auf Staging prüfen bei Dollar-Quotes oder exotischen Literalen
• Session-Historie und Datei-Upload für große Skripte statt Einfügen in Chat-Apps, die Anführungszeichen verändern
• Mit Text Diff kombinieren beim Vergleich zweier formatierter Versionen derselben Report-Abfrage