// 無料のツール

SQL Server フォーマッタ (T-SQL)

SQL Server と Azure SQL 向けに T-SQL をフォーマットします。角括弧で囲まれた名前、@変数、#temp テーブル、GO バッチを SQL Server と同じ規則で読み取り、スクリプトがデバイスの外に出ることはありません。

.sql ファイルをここにドロップすると開きます。読み込むのはブラウザーの中だけで、アップロードはされません。

フォーマット後の 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…

エディターのショートカット: Ctrl+Enter フォーマットと Ctrl+Shift+Enter ミニファイします(⌘ 代わりに Ctrl Mac では)。設定はこのブラウザに記憶され、ページのアドレスにも保存されるため、リンクで共有されるのはスタイルだけで、SQL は共有されません。

フォーマッターが SQL Server SQL に対して行うこと

  • 角かっこ付きの名前は正確に保たれます。 [Order Details] そして [dbo].[Orders] は引用符付きの名前で、 ]] エスケープも含みます。次を設定してください 引用符の扱い に 常に引用符で囲む フォーマッターがブラケットを追加します。 不要な引用符を削除 予約語ではない通常の名前からのみ取り除くので、 Shared.[User] 角括弧は保持されます。 必要な場合のみ引用符を付ける 予約語が名前として使われている箇所にも、それらを追加します: Shared.User になります Shared.[User].
  • 変数と一時テーブルは名前です。 @since, @@ROWCOUNT, #recent, ##shared そして OUTPUT $action はそれぞれ1つのトークンとして読み取られるため、何も分割されません。
  • GO バッチは独立した行に配置されます。 A GO 行。次のような繰り返し回数を任意で指定できます GO 5 そして大文字小文字は問わず、常に単独の行に置かれます。たまたま同じ名前の列は go はそれと誤認されません。
  • T-SQL の句が適切にレイアウトされます。 TOP, CROSS APPLY, MERGE … WHEN [NOT] MATCHED, OUTPUT 、そして次のようなテーブルヒント WITH (NOLOCK) 意味を保ち、 N'…' Unicode 文字列には一切手を加えません。
  • 自動検出は T-SQL を認識します ブラケット付きの名前を検出したとき、 @ パラメーターまたは GO 行。
  • ミニファイしてもGOは保持されます。 スクリプトを 1 行にまとめても、各 GO SQL Serverのツールがそれを要求するため、独立した行に置きます。

知っておくと便利なこと

  • プロシージャルな T-SQL は有効なままで、プロシージャ内のステートメントは 1 つずつ整形されますが、 BEGIN … END, IF そして WHILE ブロックは再インデントされません。
  • 次のような ODBC エスケープシーケンスを含む SQL {fn NOW()} は変更されずに返され、フォーマッターが止まった位置を示すメモが付きます。

例

SQL Serverの整形前と整形後

前
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
次の後
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

出力は、上のフォーマッターが生成するのとまったく同じ、4 スペース インデントの「標準」スタイルです。スタイルを切り替えるには、 コンパクト より高密度な SQL または 展開済み 先頭カンマと 1 行 1 項目にします。 フォーマッターのドキュメント 詳細を説明しています。

SQL Server フォーマッタ FAQ

T-SQL フォーマッターは GO バッチセパレーターを扱えますか?

はい。GO 行は独立した行のまま保たれ、GO 5 のような繰り返し回数付きのGOも同様で、Minifyでもそのまま維持されます。ステートメント内の go という名前の列は区切りとして扱われません。

[角括弧] で囲んだ名前は変更されますか?

いいえ。角括弧付きの名前は、詳細設定で別の引用符オプションを選ばない限り、書かれたとおりに保持されます。「不要な引用符を削除」は、予約語ではない単純な名前の括弧だけを外します (そのため [User] と [Order] は括弧が残ります)。SQL Server の名前は既定の照合順序では大文字小文字を区別しないため、これは安全です。

一時テーブルや変数を含むスクリプトを整形できますか?

はい。#temp と ##global の一時テーブル、@variables、@@ システム関数、$action は単一の名前として読み取られるため、フォーマッターはスクリプトを拒否せずに整形します。

Azure SQL でも動作しますか?

はい。Azure SQL DatabaseとAzure SQL Managed Instanceは同じT-SQL方言を使うため、SQL Server (T-SQL) を選ぶか、方言を自動検出のままにしてください。

入力した SQL はサーバーに送信されますか?

いいえ。フォーマッターは WebAssembly にコンパイルされ、お使いのブラウザータブ内で実行されます。SQL がアップロード、記録、保存されることはなく、ページを読み込んだ後はオフラインでも動作し続けます。

整形でクエリが壊れることはありますか?

そうならないように作られています。整形後、SQLly は出力を入力とトークン単位で照合します。空白と指定した大文字・小文字以外が変わってしまう場合は、SQL を書いたとおりのまま返し、その理由を伝えます。終端されていない文字列のように正しく解析できない SQL も、問題の行と列を示したうえで、そのまま変更しません。

整形設定をチームで共有できますか?

はい。詳細設定を含むすべての設定は、ページのアドレスの # 記号の後ろに保持されるため、アドレスをコピーするか「設定リンクをコピー」を押せば、そのスタイルをそのまま共有できます。リンクに含まれるのは設定だけで、SQLは含まれません。

// フォーマットは序の口

フォーマッターは気に入りましたか?SQLly のほかの機能もどうぞ

macOS、Windows、Linux 用のネイティブ SQL ワークベンチ。スキーマを把握する IntelliSense、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。