// kostenloses Werkzeug

PostgreSQL-Formatter

PostgreSQL im Browser formatieren. Casts, Dollar-Quote-Rümpfe, JSONB-Operatoren und Arrays werden so gelesen, wie Postgres sie liest, der Formatter ändert also nur Leerzeichen und die Groß-/Kleinschreibung, die du verlangst.

Leg eine .sql-Datei hier ab, um sie zu öffnen. Sie wird in deinem Browser gelesen, nicht hochgeladen.

Formatiertes SQL
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

Loading the formatter…

Tastenkombinationen im Editor: Strg+Eingabe formatiert und Strg+Umschalt+Eingabe minifiziert (⌘ statt Strg auf einem Mac). Deine Einstellungen werden in diesem Browser gespeichert und in der Seitenadresse mitgeführt, sodass ein Link deinen Stil teilt – niemals dein SQL.

Was der Formatter mit PostgreSQL-SQL macht

  • Operatoren werden so gelesen, wie Postgres sie liest. PostgreSQL behandelt eine Folge von Operatorzeichen als einen einzelnen Operator, und das tut der Formatter ebenfalls: ->>, #>>, @>, <@, ?|, || und deine eigenen benutzerdefinierten Operatoren werden nie auseinandergenommen, während x>=-1 immer noch als x >= -1.
  • Typumwandlungen und Arrays bleiben unverändert. created_at::date bleibt zusammen, und ARRAY['a','b'], tags[1], tags[2:3] und text[] werden genau so beibehalten, wie sie geschrieben sind.
  • Dollar-quoted-Funktionskörper bleiben unberührt. Der Inhalt eines $$ … $$ oder $tag$ … $tag$ Strings, wie eine Funktion oder DO ein Block, kommt genau so heraus, wie er hineinging.
  • Parameter und Literale bleiben erhalten. $1 Platzhalter, psql :variables, E'…' Escape-Strings, B'…' und X'…' Bitstrings und U&'…' Unicode-Strings sind jeweils ein Token.
  • Quoting, das Groß-/Kleinschreibung sicher behandelt. PostgreSQL wandelt nicht in Anführungszeichen gesetzte Namen in Kleinbuchstaben um, daher Unnötige Anführungszeichen entfernen entfernt Anführungszeichen nur bei Namen, die bereits in Kleinbuchstaben vorliegen. "Users" behält seine Anführungszeichen.
  • Postgres-Schlüsselwörter übernehmen deine Groß-/Kleinschreibungein, einschließlich RETURNING, ILIKE, LATERAL, INTERVAL '7 days' und NULLS LAST.

Gut zu wissen

  • SQL im Körper einer Funktion ist für den Formatter ein String – er bleibt, wie er ist, statt neu formatiert zu werden.

Beispiele

PostgreSQL vorher und nachher

Vor
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
Nach
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

Die Ausgabe verwendet den Standard-Stil mit 4-Leerzeichen-Einzügen, genau so, wie der Formatierer oben sie erzeugt. Wechsle den Stil zu Kompakt für kompakteres SQL oder Erweitert für führende Kommata und ein Element pro Zeile. Die Formatter-Dokumentation behandelt die Details.

PostgreSQL-Formatter-FAQ

Zerlegt der PostgreSQL-Formatter JSONB-Operatoren wie ->> oder @>?

Nein. Operatoren liest es wie PostgreSQL, als eine zusammenhängende Folge von Operatorzeichen, sodass ->>, #>>, @>, <@, ?| und benutzerdefinierte Operatoren nie auseinandergerissen werden. Würde die Ausgabe nicht wieder dasselbe SQL lexen, gibt der Formatter deine Eingabe unverändert zurück.

Formatiert es den Inhalt einer Funktion zwischen $$-Anführungszeichen um?

Nein. Ein in Dollar-Quotes gefasster Body ist ein Stringliteral, und der Formatter ändert niemals das Innere eines Strings. Die CREATE FUNCTION-Anweisung drumherum wird trotzdem formatiert.

Entfernt es die Anführungszeichen von "MixedCase"-Namen?

Nur wenn du danach fragst, und nur, wenn es sicher ist. PostgreSQL schreibt Namen ohne Anführungszeichen klein, daher entfernt „Remove unnecessary quotes“ nur die Anführungszeichen von Namen, die bereits klein geschrieben sind und keine Schlüsselwörter sind.

Wird mein SQL an einen Server gesendet?

Nein. Der Formatter wird zu WebAssembly kompiliert und läuft in deinem Browser-Tab. Dein SQL wird nie hochgeladen, protokolliert oder gespeichert, und sobald die Seite geladen ist, funktioniert er auch offline weiter.

Kann das Formatieren meine Abfrage beschädigen?

Es ist darauf ausgelegt, das nicht zu tun. Nach dem Formatieren prüft SQLly seine Ausgabe Token für Token gegen deine Eingabe. Würde sich etwas anderes als Leerraum und die von dir gewünschte Groß-/Kleinschreibung ändern, bekommst du dein SQL genau so zurück, wie du es geschrieben hast, und es sagt dir warum. SQL, das sich nicht sauber parsen lässt, etwa ein nicht abgeschlossener String, bleibt ebenfalls unangetastet, mit Zeilen- und Spaltenangabe des Problems.

Kann ich meine Formatierungseinstellungen mit meinem Team teilen?

Ja. Jede Einstellung, auch die erweiterten, wird hinter dem #-Zeichen in der Seitenadresse mitgeführt, sodass das Kopieren der Adresse oder ein Klick auf Link zu Einstellungen kopieren genau deinen Stil weitergibt. Der Link enthält nur die Einstellungen, niemals dein SQL.

// Formatierung ist erst der Anfang

Gefällt dir der Formatter? Lern den Rest von SQLly kennen

Eine native SQL-Workbench für macOS, Windows und Linux mit IntelliSense, das dein Schema kennt, Guardrails für riskante Abfragen und genau diesem Formatter, der im Editor eingebaut ist.