// kostenloses Werkzeug

SQL Server Formatter (T-SQL)

T-SQL für SQL Server und Azure SQL formatieren. Namen in eckigen Klammern, @-Variablen, #temp-Tabellen und GO-Batches werden so gelesen, wie SQL Server sie liest, und dein Skript verlässt nie dein Gerät.

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

Formatiertes SQL
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

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

  • Namen in Klammern bleiben exakt. [Order Details] und [dbo].[Orders] sind in Anführungszeichen gesetzte Namen, ]] Escapes inklusive. Stelle Anführungszeichen zu Immer in Anführungszeichen setzen und der Formatter fügt Klammern hinzu; Unnötige Anführungszeichen entfernen entfernt sie nur aus einfachen Namen, die keine reservierten Wörter sind, also Shared.[User] behält seine Klammern. Nur bei Bedarf in Anführungszeichen setzen fügt sie auch hinzu, wenn ein reserviertes Wort als Name verwendet wird: Shared.User wird Shared.[User].
  • Variablen und temporäre Tabellen sind Namen. @since, @@ROWCOUNT, #recent, ##shared und OUTPUT $action werden jeweils als ein Token gelesen, sodass nichts auseinandergerissen wird.
  • GO-Batches behalten ihre eigene Zeile. A GO Zeile, mit einer optionalen Wiederholungszahl wie GO 5 und in beliebiger Groß- und Kleinschreibung, bleibt immer auf einer eigenen Zeile. Eine Spalte, die zufällig go genannt wird, wird nicht fälschlicherweise dafür gehalten.
  • T-SQL-Klauseln werden richtig angeordnet. TOP, CROSS APPLY, MERGE … WHEN [NOT] MATCHED, OUTPUT und Tabellenhinweise wie WITH (NOLOCK) behalten ihre Bedeutung, und N'…' Unicode-Zeichenketten werden niemals verändert.
  • Die automatische Erkennung kennt T-SQL wenn sie Namen in eckigen Klammern sieht, @ Parameter oder eine GO Zeile sieht.
  • Minify behält GO bei. Beim Zusammenfassen eines Skripts auf eine Zeile bleibt jedes GO weiterhin auf ihrer eigenen Zeile, weil SQL Server-Tools dies benötigen.

Gut zu wissen

  • Prozedurales T-SQL bleibt gültig und die Anweisungen innerhalb einer Prozedur werden einzeln aufgeführt, aber BEGIN … END, IF und WHILE Blöcke werden nicht neu eingerückt.
  • SQL mit ODBC-Escape-Sequenzen wie {fn NOW()} wird unverändert zurückgegeben, mit einem Hinweis, wo der Formatter aufgehört hat.

Beispiele

SQL Server vorher und nachher

Vor
select c.CustomerID,count(*) as Orders into #recent from dbo.Orders o join dbo.Customers c on c.CustomerID=o.CustomerID where o.OrderDate>=dateadd(day,-30,getdate()) group by c.CustomerID;
select r.CustomerID,r.Orders,@@rowcount as Total from #recent r where r.Orders>@min order by r.Orders desc;
go
drop table if exists #recent;
go
Nach
SELECT
    c.CustomerID,
    COUNT(*) AS Orders INTO #recent
FROM
    dbo.Orders o
    JOIN dbo.Customers c ON c.CustomerID = o.CustomerID
WHERE
    o.OrderDate >= DATEADD(day, -30, GETDATE())
GROUP BY
    c.CustomerID;
SELECT
    r.CustomerID,
    r.Orders,
    @@rowcount AS Total
FROM
    #recent r
WHERE
    r.Orders > @min
ORDER BY
    r.Orders DESC;
GO
DROP TABLE IF EXISTS #recent;
GO

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.

SQL Server Formatter FAQ

Behandelt der T-SQL-Formatter GO-Batch-Trennzeichen?

Ja. Eine GO-Zeile bleibt auf einer eigenen Zeile, auch GO mit Wiederholungsanzahl wie GO 5, und Minify lässt sie ebenfalls dort. Eine Spalte namens go innerhalb einer Anweisung wird nicht als Trenner behandelt.

Wird es meine [eckigen] Namen ändern?

Nein. Namen in eckigen Klammern bleiben genau so erhalten, wie sie geschrieben sind, außer du wählst in den erweiterten Einstellungen eine andere Quoting-Option. Unnötige Anführungszeichen entfernen löst die Begrenzer nur bei einfachen Namen ohne reservierte Wörter ([User] und [Order] behalten ihre Klammern), was sicher ist, weil SQL Server-Namen bei der Standard-Collation Groß- und Kleinschreibung nicht unterscheiden.

Kann es Skripte mit temporären Tabellen und Variablen formatieren?

Ja. #temp- und ##global-Temp-Tabellen, @Variablen, @@-Systemfunktionen und $action werden als einzelne Namen gelesen, sodass der Formatter das Skript anordnet, statt es abzulehnen.

Funktioniert es für Azure SQL?

Ja. Azure SQL Database und Azure SQL Managed Instance verwenden denselben T-SQL-Dialekt – wähle also SQL Server (T-SQL) oder lasse den Dialekt auf automatischer Erkennung.

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.