SQL Formatter: SQL formatieren & verschönern

Was ist SQL Formatter?

SQL Formatter ist ein browserbasiertes Tool, das unformatierte, komprimierte oder inkonsistent formatierte SQL-Abfragen in sauberen, lesbaren Code mit korrekter Einrückung und konsistenter Keyword-Schreibweise umwandelt. Entwickler und Datenanalysten stoßen ständig auf schlecht formatiertes SQL — Abfragen inline im Anwendungscode, Ausgaben aus ORM-Debug-Logs, SQL aus Dokumentationen oder Abfragen, die durch inkrementelle Bearbeitungen ihre Struktur verloren haben.

Das Tool verarbeitet dieses rohe SQL mit dialektbewusster Formatierung über die sql-formatter-Bibliothek, die die Syntaxregeln von Standard SQL, MySQL, MariaDB, PostgreSQL, PL/SQL (Oracle), T-SQL (SQL Server) und SQLite versteht. Sie können Ihren Zieldialekt wählen, die Einrückungsbreite festlegen, Keyword-Großschreibung ein- oder ausschalten und das Ergebnis minifizieren. Die gesamte Verarbeitung läuft lokal in Ihrem Browser — ohne Server, ohne Anmeldung, ohne Kosten.

Hauptfunktionen

• SQL mit korrekter Einrückung formatieren — Verwendet die sql-formatter-Bibliothek mit konfigurierbarer tabWidth und linesBetweenQueries: 2-Abstand zwischen mehreren Anweisungen.
• Unterstützung mehrerer SQL-Dialekte — Wählen Sie aus Standard SQL, MySQL, MariaDB, PostgreSQL, PL/SQL (Oracle), T-SQL (SQL Server) und SQLite. Die Dialektauswahl beeinflusst die Behandlung dialektspezifischer Syntax und reservierter Wörter.
• Anpassbare Einrückungseinstellungen — 2 oder 4 Leerzeichen Einrückung.
• Großschreibung-Umschaltung — Standardmäßig aktiv: alle SQL-Keywords werden in Großbuchstaben standardisiert (SELECT, FROM, WHERE, JOIN usw.). Deaktiviert: die originale Schreibweise bleibt erhalten.
• SQL minifizieren — Entfernt überflüssige Leerzeichen und gibt eine einzeilige Ausgabe mit einzelnen Leerzeichen zwischen Tokens aus.
• Formatierte Ausgabe in die Zwischenablage kopieren — Clipboard-API mit Textarea-Fallback.
• Als .sql-Datei herunterladen — Speichert als formatted.sql mit dem MIME-Typ text/sql.
• Tastenkürzel — Strg+Enter (Cmd+Enter) formatiert; Strg+Shift+M (Cmd+Shift+M) minifiziert.

So verwenden Sie SQL Formatter

Schritt 1: SQL einfügen

Öffnen Sie das Tool unter /developer/code/sql-formatter. Fügen Sie Ihre SQL-Abfrage oder -Abfragen in das Eingabe-Panel auf der linken Seite ein. Mehrere durch Semikolons getrennte Anweisungen werden unterstützt — der Formatter fügt zwischen den Anweisungen in der Ausgabe zwei Leerzeilen ein.

Schritt 2: Dialekt und Optionen wählen

In der Aktionsleiste unterhalb der Panels:

1. Dialekt wählen aus dem Dropdown: Standard SQL, MySQL, MariaDB, PostgreSQL, PL/SQL (Oracle), T-SQL (SQL Server) oder SQLite. Wählen Sie den Dialekt passend zu Ihrer Datenbank-Engine für die genaueste Formatierung.
2. Einrückung wählen: 2 oder 4 Leerzeichen.
3. Großschreibung umschalten: Der Uppercase-Button ist standardmäßig aktiv. Wenn aktiv, werden alle SQL-Keywords in Großbuchstaben normalisiert. Klicken Sie, um es auszuschalten und die ursprüngliche Schreibweise beizubehalten.

Schritt 3: Format klicken

Klicken Sie auf Format oder drücken Sie Strg+Enter / Cmd+Enter. Das formatierte SQL erscheint im schreibgeschützten Ausgabe-Panel. Das Tool zeigt den Dialekt im Verlaufseintrag an (z. B. „Formatted POSTGRESQL (2,4 KB)").

Beispiel-Eingabe — inline-Abfrage aus einem Anwendungs-Debug-Log:

select u.id,u.email,u.created_at,count(o.id) as order_count,sum(o.total_amount) as total_spent from users u left join orders o on u.id=o.user_id where u.active=true and u.created_at>='2024-01-01' group by u.id,u.email,u.created_at having count(o.id)>0 order by total_spent desc limit 25

Ausgabe mit PostgreSQL-Dialekt, 2-Leerzeichen-Einrückung, Großschreibung aktiv:

SELECT
  u.id,
  u.email,
  u.created_at,
  COUNT(o.id) AS order_count,
  SUM(o.total_amount) AS total_spent
FROM
  users u
  LEFT JOIN orders o ON u.id = o.user_id
WHERE
  u.active = TRUE
  AND u.created_at >= '2024-01-01'
GROUP BY
  u.id,
  u.email,
  u.created_at
HAVING
  COUNT(o.id) > 0
ORDER BY
  total_spent DESC
LIMIT
  25

Schritt 4: Minifizieren (optional)

Klicken Sie auf Minify oder drücken Sie Strg+Shift+M / Cmd+Shift+M, um eine einzeilige SQL-Zeichenkette zu erzeugen. Die Großschreibungs- und Dialekteinstellungen gelten weiterhin bei der Minifizierung. Minifiziertes SQL eignet sich zum Einbetten in Umgebungsvariablen, Konfigurationsstrings oder Vergleichs-Diffs, bei denen Zeilenänderungen störend wären.

Minifizierte Ausgabe derselben Abfrage:

SELECT u.id, u.email, u.created_at, COUNT(o.id) AS order_count, SUM(o.total_amount) AS total_spent FROM users u LEFT JOIN orders o ON u.id = o.user_id WHERE u.active = TRUE AND u.created_at >= '2024-01-01' GROUP BY u.id, u.email, u.created_at HAVING COUNT(o.id) > 0 ORDER BY total_spent DESC LIMIT 25

Schritt 5: Kopieren oder Herunterladen

Klicken Sie auf Copy, um die Ausgabe in die Zwischenablage zu legen. Klicken Sie auf Download, um formatted.sql zu speichern. Beide Buttons sind deaktiviert, bis sich eine Ausgabe im rechten Panel befindet.

Praktische Beispiele

ORM-Debug-Abfrage aufräumen

Die Debug-Ausgabe von Django oder Rails protokolliert Abfragen in einer einzigen Zeile mit gemischter Schreibweise. Ein typischer Django-Abfrage-Log-Eintrag:

select "products"."id", "products"."name", "products"."price", "products"."stock_count" from "products" where "products"."category_id" = 12 and "products"."active" = true order by "products"."name" asc

Wählen Sie den PostgreSQL-Dialekt (Django verwendet PostgreSQL-Anführung mit doppelten Anführungszeichen), aktivieren Sie Großschreibung und klicken Sie auf Format. Die Ausgabe zeigt korrekte Einrückung mit großgeschriebenen Keywords und beibehaltenen in doppelten Anführungszeichen eingeschlossenen Bezeichnern.

Gespeicherte Prozedur überprüfen

Eine T-SQL-Stored-Procedure wurde als unformatierter Block in die Versionskontrolle eingecheckt. Wählen Sie den T-SQL (SQL Server)-Dialekt und klicken Sie auf Format für eine eingerückte, lesbare Version mit konsistenter Keyword-Schreibweise. Die formatierte Version ist in einem Pull-Request-Diff leichter zu überprüfen und kann zurück eingecheckt werden.

Abfrage in Konfiguration einbetten

Ihre Anwendung speichert eine Berichtsabfrage in einer YAML-Konfigurationsdatei als einzeilige Zeichenkette. Erstellen und testen Sie die Abfrage mit korrekter Formatierung im SQL Formatter, dann klicken Sie auf Minify für die kompakte Version zum Einbetten. Die formatierte Version in einem Kommentar neben der minifizierten zu behalten, macht die Konfigurationsdatei wartbar.

# Formatierte Version (für Lesbarkeit):
# SELECT product_id, SUM(quantity) AS units_sold
# FROM order_items
# WHERE order_date >= :start_date
# GROUP BY product_id
# ORDER BY units_sold DESC

report_query: "SELECT product_id, SUM(quantity) AS units_sold FROM order_items WHERE order_date >= :start_date GROUP BY product_id ORDER BY units_sold DESC"

Tipps und Best Practices

Dialekt an Ihre Datenbank anpassen. Obwohl die meiste SQL-Formatierung dialektunabhängig ist, behandelt die sql-formatter-Bibliothek dialektspezifische Syntax (wie :: Cast-Syntax in PostgreSQL, TOP in T-SQL und Unterschiede bei LIMIT/OFFSET) genauer, wenn der korrekte Dialekt gewählt ist.

Großschreibung für Code-Review-Lesbarkeit. Die SQL-Konvention großgeschriebener Keywords ist allgemein anerkannt und macht strukturelle Komponenten (SELECT, FROM, WHERE, JOIN) visuell von Bezeichnern und Literalen unterscheidbar. Aktivieren Sie die Großschreibung vor dem Formatieren von Code, der überprüft oder eingecheckt werden soll.

Vor dem Vergleichen formatieren. Beim Vergleichen zweier Versionen einer Abfrage sollten Sie beide zuerst mit denselben Einstellungen formatieren. Diffs auf unformatiertem SQL erzeugen unübersichtliche Ausgaben, da eine einzelne strukturelle Änderung viele Zeilen betreffen kann. Formatierte SQL-Diffs zeigen nur bedeutungsvolle Änderungen.

Mehrere Anweisungen funktionieren. Sie können eine Migrationsdatei oder ein Skript mit mehreren CREATE TABLE-, INSERT- und ALTER TABLE-Anweisungen getrennt durch Semikolons einfügen. Der Formatter fügt zwischen den Anweisungen zwei Leerzeilen zur visuellen Trennung ein.

Presets für Team-Konventionen speichern. Glyph-Widgets-Unterstützer können Dialekt, Einrückung und Großschreibungseinstellungen als benanntes Preset speichern. Erstellen Sie ein Preset pro Projekt (z. B. „MySQL 2-Leerzeichen Großbuchstaben"), um die Konventionen Ihres Teams bei Projektwechseln mit einem Klick anzuwenden.

Häufige Probleme und Fehlerbehebung

Fehlermeldung nach Format-Klick — Die sql-formatter-Bibliothek löst bei nicht erkannter Syntax einen Fehler aus. Häufige Ursachen: proprietäre Erweiterungen, die vom gewählten Dialekt nicht unterstützt werden, prozeduraler Code (PL/pgSQL-Funktionskörper, T-SQL-BEGIN/END-Blöcke) oder SQL gemischt mit Anwendungsschicht-Template-Syntax wie {{ variable }} oder #{variable}. Entfernen oder kommentieren Sie nicht unterstützte Teile vor dem Formatieren aus.

Keywords werden nicht großgeschrieben — Bestätigen Sie, dass der Uppercase-Button aktiv ist (ausgefüllt, Primärstil). Wenn der Button im Outline-Stil angezeigt wird, ist die Schreibweise auf preserve gesetzt. Klicken Sie einmal, um den Uppercase-Modus zu aktivieren.

Falscher Dialekt verursacht unerwartete Zeilenumbrüche — Die Zeilenumbruchregeln der sql-formatter-Bibliothek variieren je nach Dialekt. Wenn eine Abfrage seltsam formatiert wird, versuchen Sie Standard SQL als Dialekt. PL/SQL und T-SQL-Dialekte können Unterabfragen anders formatieren als Standard SQL.

Minifizierte Ausgabe hat stellenweise noch mehrere Leerzeichen — Der Minifizierungsansatz reduziert alle Leezeichenfolgen auf einzelne Leerzeichen. Wenn der Formatter jedoch absichtliche Zeilenumbrüche innerhalb von Zeichenfolgenliteralen oder Kommentaren einfügt, wird ein einzelnes Leerzeichen eingefügt. Inhalt in Anführungszeichen ist nicht betroffen — Leerzeichen innerhalb von einfach zitierten Zeichenketten bleiben erhalten.

Fehler „Please enter SQL to format" — Die Eingabe ist leer. Fügen Sie eine SQL-Abfrage in das linke Panel ein, bevor Sie auf Format klicken.

Heruntergeladene Datei heißt jedes Mal formatted.sql — Dies ist der feste Dateiname. Benennen Sie die Datei nach dem Herunterladen entsprechend der Namenskonvention Ihres Projekts um.

Datenschutz und Sicherheit

SQL Formatter verarbeitet allen SQL-Text lokal in Ihrem Browser mithilfe der sql-formatter-Bibliothek. Kein Abfragetext — einschließlich Tabellennamen, Spaltennamen, Datenwerte, Zugangsdaten in Verbindungsstrings oder andere Inhalte — wird an einen Server gesendet. Das Tool funktioniert offline, sobald die Seite geladen ist. Dies macht es sicher für den Einsatz mit proprietären Schemanamen, interner Geschäftslogik oder Abfragen mit Beispieldaten.

Häufig gestellte Fragen

Ist SQL Formatter kostenlos? Ja, vollständig kostenlos. Alle Formatierungs-, Minifizierungs- und Dialektoptionen sind ohne Gebühr oder Konto verfügbar. Glyph-Widgets-Unterstützer-Funktionen wie gespeicherte Presets und Sitzungsverlauf stehen Ko-fi-Unterstützern zur Verfügung, aber die Kern-SQL-Formatierung ist uneingeschränkt.

Funktioniert es offline? Ja. Nach dem Laden der Seite läuft die gesamte Formatierung lokal in Ihrem Browser mit JavaScript. Sie können die Internetverbindung trennen und Abfragen weiter formatieren.

Ist mein SQL sicher? Ja. Ihr SQL wird niemals an einen Server übertragen. Es wird vollständig im Browser-Speicher verarbeitet und verworfen, wenn Sie das Tool leeren oder den Tab schließen. Sie können sicher Abfragen mit internen Tabellennamen, Geschäftslogik oder Beispieldatenwerten einfügen.

Welche SQL-Dialekte werden unterstützt? Das Tool unterstützt Standard SQL, MySQL, MariaDB, PostgreSQL, PL/SQL (Oracle), T-SQL (SQL Server) und SQLite. Diese entsprechen direkt dem language-Parameter der sql-formatter-Bibliothek.

Validiert das Tool SQL-Syntax? Die sql-formatter-Bibliothek führt genug Parsing durch, um SQL zu formatieren, und löst bei bestimmter nicht verarbeitbarer Syntax einen Fehler aus — ist aber kein strikter SQL-Validator. Für echte Syntaxvalidierung verwenden Sie EXPLAIN oder den Query-Planer Ihrer Datenbank-Engine.

Kann ich mehrere Abfragen gleichzeitig formatieren? Ja. Fügen Sie mehrere durch Semikolons getrennte Anweisungen ein. Der Formatter fügt zwischen den formatierten Anweisungen zwei Leerzeilen ein, um die Grenzen zwischen Abfragen deutlich zu machen.

Was macht die Großschreibung-Umschaltung genau? Wenn aktiviert, setzt der Formatter keywordCase: 'upper' in den sql-formatter-Optionen, wodurch alle reservierten SQL-Wörter in Großbuchstaben konvertiert werden — SELECT, FROM, WHERE, JOIN, ON, GROUP BY, ORDER BY, LIMIT, Funktionsnamen wie COUNT, SUM, MAX usw. Wenn deaktiviert, lässt keywordCase: 'preserve' die originale Schreibweise der Eingabe unverändert.

Kann der Formatter CTEs (Common Table Expressions) verarbeiten? Ja. CTEs (WITH ... AS (...)) werden korrekt mit richtiger Einrückung für die CTE-Definition und die folgende Hauptabfrage formatiert. Dies gilt für alle unterstützten Dialekte.

Wie lautet das Tastenkürzel zum Formatieren? Strg+Enter unter Windows/Linux oder Cmd+Enter unter macOS. Zum Minifizieren: Strg+Shift+M unter Windows/Linux oder Cmd+Shift+M unter macOS.

Kann ich DDL-Anweisungen wie CREATE TABLE formatieren? Ja. Die sql-formatter-Bibliothek verarbeitet DDL (CREATE TABLE, ALTER TABLE, DROP TABLE, CREATE INDEX usw.) sowie DML (SELECT, INSERT, UPDATE, DELETE) und DCL (GRANT, REVOKE). Gemischte Skripte mit DDL und DML werden korrekt formatiert, wenn sie durch Semikolons getrennt sind.

Verwandte Tools

JSON Formatter — JSON-Daten mit Schema-Validierung, Schema-Generierung und einem interaktiven Tree-Viewer formatieren und validieren.

XML Formatter — XML-Dokumente mit konfigurierbarer Einrückung und Minifizierung formatieren und validieren.

YAML Formatter — YAML-Konfigurationsdateien formatieren und in JSON konvertieren.

Jetzt SQL Formatter ausprobieren: SQL Formatter