SQL Format

SQL Format とは何か、誰のためのものか

SQL Format は、詰め込まれた SQL、1 行に書かれた SQL、インデントが不揃いな SQL を、すっきりとした予測可能なレイアウトに整える無料のオンラインフォーマッターです。各句は新しい行から始まり、列リストは 1 行に 1 項目ずつ分割され、結合とその条件は所属するテーブルの下にインデントされ、ネストしたクエリは括弧の内側にインデントされます。

SQL を一日中読む人のために作られています。プルリクエストをレビューする開発者、ログから取り出した遅いクエリを解きほぐす DBA、共有前にレポートを整えるアナリスト、そして 1 行に書かれた 300 行分のステートメントを引き継いだことのあるすべての人です。レイアウトはデータベースチームで長く使われてきた慣例に従っており、下記のオプションでチーム独自のスタイルに合わせることができます。

フォーマッターの使い方

1. エディタに SQL を貼り付けるか入力します。複数のステートメントをまとめて貼り付けることもでき、セミコロンで分割されて順番にフォーマットされます。
2. 必要に応じてオプションを調整します：インデント幅、最大行幅、カンマの位置、キーワードの大文字・小文字、開き括弧を独立した行に置くかどうか。
3. フォーマット をクリックするか、Ctrl + Enter（Mac では ⌘ + Enter）を押します。フォーマットされた SQL がエディタ内のテキストを置き換えます。
4. コピー で結果をクリップボードにコピーし、クリア で最初からやり直せます。ステータスバーには行数と文字数、およびカーソル位置が表示されます。

書式オプション

出力は 5 つのオプションで制御します。デフォルト（インデント 4 スペース、120 列、末尾カンマ、キーワードは大文字、括弧は同じ行）はほとんどのチームに適しています。各オプションには、さらに多くの例を載せた専用ページがあります。

インデント幅

インデント幅 は、ネストの各レベルで使うスペースの数を 0 以上で設定します。デフォルトは 4 です。入力中のタブ文字は、文字列リテラルと引用符で囲まれた識別子の内部を除き、その数のスペースに置き換えられます。下の例では 2 を使用しています。

SELECT c.name,
  SUM(o.total) AS revenue
FROM customers c
  JOIN orders o
    ON  o.customer_id = c.id
WHERE o.status = 'PAID'
GROUP BY c.name

詳しくはこちら：「インデント幅」オプション

最大列数

最大列数 は、フォーマッターが目標とする行幅です（デフォルトは 120）。長い式はこの幅に収まるよう複数行に分割されます。0 にすると折り返しは無効になります。

SELECT order_id,
    quantity * unit_price * (1 - discount_rate) * (1 +
      tax_rate) + shipping_fee - loyalty_credit AS
      amount_due
FROM order_lines
WHERE order_id = 42

詳しくはこちら：「最大列数」オプション

カンマ

カンマ では、末尾カンマ（各項目の後ろ。デフォルト）と先頭カンマ（次の行の先頭）のどちらかを選びます。先頭カンマにすると列を簡単にコメントアウトでき、末尾に列を追加したときの差分も小さくなります。

SELECT id
    ,email
    ,country_code
    ,created_at
FROM customers

詳しくはこちら：「カンマ」オプション（カンマの位置）

キーワード

キーワード は、SELECT、FROM、JOIN などの SQL キーワードを大文字（デフォルト）または小文字に切り替えます。文字列リテラルとコメントは書いたとおりに残ります。

select id,
    name
from products
where price > 100
order by name

詳しくはこちら：「キーワード」オプション（大文字・小文字）

括弧を新しい行に

括弧を新しい行に は、IN の後のサブクエリ、CTE の本体、複数行に分割されたリストなど、ブロックの開き括弧を前の行末に残さず、独立した行に移動します。

SELECT name
FROM customers
WHERE id IN
(
    SELECT customer_id
    FROM orders
    WHERE total > 500
)

詳しくはこちら：「括弧を新しい行に」オプション

対応している SQL 方言

このフォーマッターは特定のデータベースに縛られません。主要なエンジンに共通する SQL を扱います：結合、サブクエリ、CASE を含む SELECT、INSERT、UPDATE、DELETE、CREATE TABLE や CREATE VIEW などの一般的な DDL、そして -- 形式と /* */ 形式の両方のコメント（コメントは保持されます）です。

PostgreSQL には追加のサポートがあります：:: キャスト、$1 パラメーター、ドル引用符で囲まれた $$ … $$ 本体で、本体内の PL/pgSQL はブロックごとにレイアウトされます。MySQL のバッククォート識別子と SQL Server の [bracket] 識別子はそのまま保持されます。方言の切り替えはないため、SQL Server の GO バッチ区切りなど、特定のデータベースに固有のその他の構文は特別には扱われません。違いについては方言ガイドで説明しています。

• PostgreSQL クエリと PL/pgSQL の整形
• 整形に影響する SQL 方言の違い

入力した SQL の扱い

「フォーマット」をクリックすると、エディタ内の SQL は HTTPS 経由で当社のサーバーに送信され、メモリ上でフォーマットされて、そのままページに返されます。データベース、ファイル、ログに書き込まれることはなく、解析パートナーや広告パートナーと共有されることもありません。それでも、実際のパスワード、キー、個人データはどのオンラインツールにも貼り付けないでください。詳細はプライバシーページをご覧ください。

プライバシー情報

よくある質問

よくある質問をすべて見る

ガイドとリファレンス

ツール本体に加えて、以下のガイドでは読みやすい SQL の背景にある慣例を解説しています：

• SQL スタイルガイド
• 複雑な SQL クエリの整形方法
• SQL の行頭カンマと行末カンマ
• コードレビューとバージョン管理のための SQL 整形
• SQL の読みやすさを損なうよくある間違い
• PostgreSQL クエリと PL/pgSQL の整形
• 整形に影響する SQL 方言の違い
• マイグレーションのデプロイ前の SQL 整形チェックリスト
• オプションのドキュメント：各設定の働きを例とともに解説