// kostenloses Werkzeug

BigQuery SQL-Formatter

GoogleSQL für BigQuery im Browser formatieren. Backtick-Tabellenpfade, Abfrageparameter, Arrays und QUALIFY bleiben unangetastet und werden übersichtlich ausgegeben.

Der Formatter liest BigQuery SQL nach seinen MySQL-Regeln, zusätzlich zur unten aufgeführten BigQuery-Syntax.

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

Formatiertes SQL
SELECT
    user_id,
    COUNT(*) AS sessions,
    ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
    `my-project.analytics.events`
WHERE
    event_name = @event
    AND 'beta' IN UNNEST(tags)
    AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
    user_id
QUALIFY
    ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100

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 BigQuery SQL macht

  • Backtick-Tabellenpfade. `my-project.analytics.events` ist ein einzelner in Anführungszeichen gesetzter Name, inklusive Bindestrichen.
  • Abfrageparameter. @event benannte Parameter werden als einzelne Tokens gelesen.
  • Arrays bleiben so wie geschrieben. [1, 2, 3] Literale und arr[OFFSET(0)] Subskripte bleiben genau so erhalten, wie du sie getippt hast, und UNNEST, STRUCT und ARRAY_AGG Aufrufe werden wie jede Funktion formatiert.
  • QUALIFY bekommt eine eigene Klausel, aufgebaut wie HAVING, und INTERVAL und OVER (PARTITION BY …) übernehmen die Groß-/Kleinschreibung deiner Schlüsselwörter.
  • Kommentare und Zeichenketten. # Kommentare werden beibehalten, Text in doppelten Anführungszeichen ist ein String, und r'…' raw- und b'…' Bytes-Literale bleiben an ihrem Präfix angehängt.

Gut zu wissen

  • Die Groß-/Kleinschreibung von Schlüsselwörtern deckt Standard-SQL- und MySQL-Schlüsselwörter ab, sodass einige Wörter, die es nur in BigQuery gibt, die von dir getippte Schreibweise behalten.

Beispiele

BigQuery vorher und nachher

Vor
select user_id, count(*) as sessions, array_agg(page order by ts limit 5) as first_pages from `my-project.analytics.events` where event_name = @event and 'beta' in unnest(tags) and ts >= timestamp_sub(current_timestamp(), interval 7 day) group by user_id qualify row_number() over (order by count(*) desc) <= 100
Nach
SELECT
    user_id,
    COUNT(*) AS sessions,
    ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
    `my-project.analytics.events`
WHERE
    event_name = @event
    AND 'beta' IN UNNEST(tags)
    AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
    user_id
QUALIFY
    ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100

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.

BigQuery-Formatter FAQ

Wie liest der Formatter BigQuery SQL?

Mit seinen MySQL-Regeln, die sich BigQuerys Backtick-Quoting, #-Kommentare und Strings in doppelten Anführungszeichen teilen. Darüber hinaus versteht er @-Parameter, [ ]-Arrays und QUALIFY.

Wird er meine Backtick-Namen der Form project.dataset.table beschädigen?

Nein. Ein mit Backticks gekennzeichneter Pfad ist dem Formatter ein einzelner Name, daher wird er genau so beibehalten, wie er geschrieben ist.

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.