PostgreSQL-Formatter
Formatiere PostgreSQL-Abfragen und Skripte nach Postgres-Regeln für Funktionskörper in Dollar-Quotes, E''-Escape-Strings, Bezeichner in doppelten Anführungszeichen, ::-Casts und JSON-Operatoren wie ->> und @>. Klauseln wie RETURNING, ON CONFLICT und DO UPDATE SET erhalten jeweils eine eigene Zeile. Nicht geschlossene Strings, Kommentare oder Klammern werden mit Zeile und Spalte gemeldet. Für Entwickler, die Migrationen und Abfragen lesen.
Häufig gestellte Fragen
Welche PostgreSQL-Syntax wird erkannt?
Standard-Strings mit verdoppelten Anführungszeichen, E''-Strings mit Backslash-Escapes, U&''-Unicode-Strings, B''- und X''-Bit-Strings, Bezeichner in doppelten Anführungszeichen und $1-Parameter werden erkannt. Auch Dollar-Strings wie $$...$$ oder $body$...$body$ werden gelesen.
Was passiert mit Funktionskörpern in Dollar-Quotes?
Ein Körper in Dollar-Quotes bleibt exakt so, wie er geschrieben wurde, weil er für PostgreSQL ein String ist. Die umgebende CREATE FUNCTION-Anweisung wird formatiert, der Körper selbst bleibt unverändert.
Bleiben Casts und Operatoren intakt?
Ja. Casts wie value::integer bleiben verbunden, und Operatoren wie ->, ->>, #>, #>>, @>, <@, ?|, ?&, @@ sowie die regulären Ausdrucksoperatoren ~ und ~* samt ihren negierten Formen werden nie aufgetrennt. In PostgreSQL ist # ein Operator, kein Kommentar.
Welche PostgreSQL-Klauseln erhalten eine eigene Zeile?
RETURNING, ON CONFLICT, DO UPDATE SET, FOR UPDATE, FOR NO KEY UPDATE, FOR SHARE und FOR KEY SHARE bleiben als Klauseln zusammen. Die üblichen SELECT-, FROM-, WHERE-, GROUP BY-, ORDER BY-, LIMIT- und OFFSET-Klauseln beginnen ebenfalls in einer neuen Zeile.
Bleiben Kommentare erhalten?
Ja. Zeilen- und Blockkommentare bleiben an ihrer Stelle, und verschachtelte Blockkommentare, die PostgreSQL ermöglicht, werden korrekt gelesen. Mehrzeilige Blockkommentare werden an ihrer neuen Position neu eingerückt.
Wird MERGE unterstützt?
Ja. WHEN MATCHED- und WHEN NOT MATCHED-Zweige beginnen in einer neuen Zeile, sodass MERGE-Anweisungen ab PostgreSQL 15 lesbar bleiben.
Ändert das die Groß- und Kleinschreibung von Schlüsselwörtern?
Nein. Schlüsselwörter und Bezeichner behalten die Groß- und Kleinschreibung deiner Eingabe bei. Bezeichner in Anführungszeichen unterscheiden in PostgreSQL zwischen Groß- und Kleinschreibung und bleiben unverändert.
Welche Fehler werden erkannt?
Nicht geschlossene Zeichenfolgen, Bezeichner in Anführungszeichen, Dollar-Quoted-Strings und Blockkommentare sowie unausgeglichene Klammern werden mit Zeile und Spalte gemeldet. Das Tool prüft weder die vollständige PostgreSQL-Grammatik noch dein Schema.
Wie groß darf die Eingabe sein?
Bis zu 1 MB pro Anfrage und 128 KB pro Anweisung. Migrationsdateien mit vielen Anweisungen werden einzeln formatiert und durch Leerzeilen getrennt.
Kann ich die Einrückung wählen?
Ja. Verwende 2 oder 4 Leerzeichen oder Tabulatoren. Dein SQL wird nur im Arbeitsspeicher verarbeitet und niemals gespeichert.