SQL フォーマッタ

SQLフォーマッターとは？

SQLフォーマッターは、ぎっしり詰まった一行SQLやORMが吐き出した自動生成のSQLを受け取り、インデントと改行を統一した形に書き直します。コードレビューでJOINを確認したい、フィルターをデバッグしたい、ORMの出力を整理したい、チケットやドキュメントにSQLを貼りたい、クエリプランを順番に追いたい――そんな場面で頻繁に出番があります。

整形してもクエリの「動作」は変わりません。変わるのは「人間にとっての読みやすさ」だけです。レイアウトが揃うと、SELECT・FROM・JOIN・WHERE・GROUP BY・HAVING・ORDER BY の関係性がグッと把握しやすくなります。サブクエリやCTEが入り混じった複雑なクエリほど効果は大きいです。

SQLには「方言」がたくさんあります。PostgreSQL、MySQL、SQLite、T-SQL（Microsoft SQL Server）、Oracle、BigQueryなど、それぞれが標準SQLを独自に拡張しています。しっかりしたフォーマッターは選択した方言を理解しているので、ベンダー固有の構文を壊さずに整形してくれます。

SQLを整形しながら身につくこと

• SQLの各句にはそれぞれ役割があります。SELECT は列の選択、FROM はテーブル指定、WHERE は行のフィルタリング、GROUP BY は集約、ORDER BY は並び替えです。
• 適切なインデントは、一行SQLでは見えなかったネストしたクエリ、JOIN、条件の構造をはっきり浮かび上がらせます。
• 方言は無視できません。RETURNING、LIMIT、TOP、識別子のクォート（[col] と "col" など）はDB間で互換性がありません。

SQLクエリを整形する手順

1. 1

   クエリを貼り付ける

   入力欄にSQLを貼り付けます。一行のもの、ORMが生成したもの、途中まで整形済みのもの、どれでもOKです。

2. 2

   方言を選ぶ

   PostgreSQL、MySQL、SQLite、T-SQLから選択。これで LIMIT、TOP、RETURNING などベンダー固有のキーワードが正しく扱われます。

3. 3

   スタイルを設定

   キーワードの大文字／小文字（大文字が一般的）と、インデント幅（2か4スペース）を選びます。多くのチームは「キーワード大文字＋2スペース」が定番です。

4. 4

   整形結果を読む

   各句が独立した行に並び、JOINは揃い、サブクエリにはインデントが入ります。コメントもそのまま残ります。

5. 5

   プロジェクトに戻して使う

   整形後のクエリをマイグレーションファイル、ORMの生クエリ、BIツールなどに貼り戻してください。処理はすべてブラウザ内で完結しています。

SQL句クイックリファレンス

SELECT クエリの95%で登場する句を、概念上の処理順に並べました。公式ドキュメント: PostgreSQL SELECT、MySQL SELECT。

試してみたいSQLの例

select id,name from users where active=true order by created_at desc limit 10

SELECT  id,  nameFROM usersWHERE active = trueORDER BY created_at DESCLIMIT 10;

select u.name,o.total from users u join orders o on o.user_id=u.id where o.total>100

SELECT  u.name,  o.totalFROM users uJOIN orders o ON o.user_id = u.idWHERE o.total > 100;

select * from users where id in (select user_id from enrollments where course_id=5)

SELECT *FROM usersWHERE id IN (  SELECT user_id  FROM enrollments  WHERE course_id = 5);

SQL整形でよくある落とし穴

• 「整形済みSQL」と「正しいSQL」を混同しないこと。整形が変えるのは見た目だけで、意味は変わりません。きれいに整っていても、結果が間違っていることはあります。
• 整形のついでにクエリを修正してしまい、再テストを忘れるパターン。
• 方言を意識しないこと。PostgreSQLの LIMIT 10、T-SQLの TOP 10、標準SQLの FETCH FIRST 10 ROWS ONLY はどれも同じ意味ですが、書き方が違います。

SQLフォーマッターに関するFAQ