SQL-Formatter

Vorher und nachher

Vorher:

SELECT u.id,u.name,COUNT(o.id) AS orders FROM users u LEFT JOIN orders o ON o.user_id=u.id WHERE u.created_at>='2024-01-01' GROUP BY u.id,u.name HAVING COUNT(o.id)>5 ORDER BY orders DESC LIMIT 50;

Nachher (führendes Komma, Großbuchstaben für Schlüsselwörter, 2 Leerzeichen Einrückung):

SELECT
    u.id
  , u.name
  , COUNT(o.id) AS orders
FROM users u
LEFT JOIN orders o
  ON o.user_id = u.id
WHERE u.created_at >= '2024-01-01'
GROUP BY u.id, u.name
HAVING COUNT(o.id) > 5
ORDER BY orders DESC
LIMIT 50;

Stilentscheidungen, die wichtig sind

• Großbuchstaben vs. Kleinbuchstaben für Schlüsselwörter. GROSSBUCHSTABEN ist traditionell und gut lesbar. Kleinbuchstaben sind in modernen Code-Editoren mit Syntaxhervorhebung sauberer.
• Führende vs. nachfolgende Kommas. Führende ( , col) erleichtert das Kommentieren einer einzelnen Spalte. Nachfolgende (col,) liest sich natürlicher im Text.
• Kommaplatzierung in GROUP BY. Oft eine pro Zeile für lange Klauseln, inline für kurze.
• JOIN-Einrückung. ON in der nächsten Zeile (hängende Einrückung) vs. in derselben Zeile. Lange Bedingungen profitieren von hängenden Einrückungen.
• Unterabfragen. Die gesamte Unterabfrage einrücken, nicht nur die öffnende Klammer.

Dialekt-spezifische Fallstricke

• MySQL-Backticks vs. PostgreSQL-Doppelanführungszeichen für Bezeichner.
• WITH CTEs, MS SQL hat eine ;-Anforderung vor WITH; der Formatter kümmert sich darum.
• Fensterfunktionen, lange OVER (...)-Klauseln profitieren von umgebrochenem PARTITION BY und ORDER BY.
• BigQuery hat ARRAY_AGG, STRUCT und Tabellensuffixe (*_yyyymmdd), die der Tokenizer nicht brechen darf.
• Oracle hat die (+)-Syntax für äußere Joins, der Formatter bewahrt sie, kennzeichnet sie jedoch als veraltet.

Was der Formatter nicht tut

• Fehler beheben, ein ungültiger JOIN bleibt ungültig.
• SELECT * erweitern, Spaltenlisten werden nicht aus dem Schema abgeleitet.
• Abfragen optimieren, nur Layout, keine Ausführungspläne.
• Unterabfragen als CTEs umschreiben, ein anderes Anliegen.