SQLを書いていると、あとから見返した時に「自分で書いたSQLなのに読みにくい」と感じた経験はないでしょうか。
特にJOINやサブクエリが増えたSQLは、改行やインデントが崩れるだけで可読性が大きく低下します。
実務ではSQLの正しさだけでなく「他人が読めるか」が非常に重要です。レビュー効率や障害調査の速度にも直結します。
そこで役立つのが SQL Formatter（SQL整形ツール） です。
SQL Formatterを使えば、貼り付けるだけでSQLを自動整形でき、可読性を一瞬で改善できます。
本記事では、実務で使いやすいSQL Formatterのおすすめと具体的な使い方について解説します。
SQL Formatterとは
SQL Formatterとは、改行・インデント・キーワードの配置を自動調整し、SQLを読みやすい形式へ整形するツールです。
例えば次のようなSQLでも、
|
1 |
SELECT a.id,a.name,b.order_id FROM users a LEFT JOIN orders b ON a.id=b.user_id WHERE a.status='1' ORDER BY a.id; |
Formatterを使用すると以下のように整形されます。
|
1 2 3 4 5 6 7 8 9 |
SELECT a.id, a.name, b.order_id FROM users a LEFT JOIN orders b ON a.id = b.user_id WHERE a.status = '1' ORDER BY a.id; |
SQLの意味は同じでも、可読性は大きく変わります。
SQL Formatterを使うメリット
| 項目 | 効果 |
|---|---|
| 可読性向上 | SQL構造が一目で分かる |
| レビュー効率改善 | 差分確認が容易 |
| バグ防止 | 条件漏れに気付きやすい |
| チーム統一 | コーディングルールを統一可能 |
| 作業時間短縮 | 手動整形が不要 |
特に保守フェーズでは「読めるSQL」が重要になります。
おすすめSQL Formatterツール
SQL Formatter（Instant SQL Formatter）
もっとも手軽に使えるオンラインFormatterです。
特徴
・ブラウザのみで利用可能
・インストール不要
・Oracle / MySQL / PostgreSQL対応
・設定項目が豊富
検索すると「Instant SQL Formatter」で表示されます。
SQLFormat.org
シンプル操作を重視する場合はこちらです。
特徴
・貼り付けてボタンを押すだけ
・初心者向けUI
・基本整形に最適
細かい設定は不要で、とにかく整形したい場合に向いています。
VS Code拡張機能（SQL Formatter）
開発環境で自動整形したい場合に最もおすすめです。
拡張機能名
SQL Formatter
主な機能
・保存時自動フォーマット
・ショートカット整形
・複数DB対応
SQL Formatterの基本的な使い方（オンライン）
手順は非常にシンプルです。
STEP1：SQLをコピーする
整形したいSQL文をそのままコピーします。
STEP2：Formatterへ貼り付ける
入力エリアへSQLを貼り付けます。
STEP3：Format SQLを実行
「Format」または「Format SQL」ボタンをクリックします。
STEP4：整形済SQLをコピー
整形後のSQLをコピーして利用します。
これだけでSQL整形は完了です。
Formatter設定で重要なポイント
Formatterには多くの設定がありますが、実務で重要なのは以下です。
| 設定項目 | 推奨内容 | 理由 |
|---|---|---|
| Keyword Case | Upper | SELECTなどを大文字統一 |
| Indentation | 4 spaces | 可読性が高い |
| Line Break Before JOIN | Enabled | JOIN構造が見やすい |
| Line Break Before WHERE | Enabled | 条件確認しやすい |
| Comma Position | End of line | 一般的なSQL形式 |
チーム開発では設定を統一することが重要です。
VS CodeでSQLを自動整形する方法
STEP1：拡張機能を開く
左メニュー「拡張機能」をクリック。
STEP2：「SQL Formatter」を検索
検索欄で以下を入力します。
SQL Formatter
STEP3：インストール
該当拡張機能をインストールします。
STEP4：フォーマット実行
ショートカットキー：
Shift + Alt + F
これでSQLが自動整形されます。
SQL Formatterを使うべきタイミング
次の場面では必ずFormatter使用をおすすめします。
・レビュー提出前
・本番反映前
・障害調査時
・長いJOIN作成後
・サブクエリ追加後
整形してから確認するだけで、ミス発見率が大きく変わります。
Formatter使用時の注意点
SQLの意味は変わらないか確認する
Formatterは基本的に構文変更を行いませんが、念のため実行確認は必要です。
独自SQL方言に注意
DB製品固有構文は崩れる場合があります。
例
・Oracleヒント句
・SQL Server特殊構文
・ストアド専用構文
整形後は必ず確認してください。
なお、SQLの可読性を改善すると処理内容の問題にも気付きやすくなります。
特にUPDATE処理が遅い場合は、SQL構文ではなくINDEX構造が原因になっているケースも少なくありません。
よくある質問（Q & A）
- SQL FormatterでSQLの処理速度は変わりますか？
-
変わりません。Formatterは見た目のみを整形します。
- Formatterは安全に使えますか？
-
基本的に安全ですが、本番SQLは整形後に必ず実行確認を行ってください。
- チーム開発ではFormatterを使うべきですか？
-
はい。SQLスタイル統一によりレビュー効率が大幅に向上します。
- オフライン環境でも使用できますか？
-
VS Codeなどの拡張機能を利用すれば可能です。
まとめ
SQL Formatterを利用すると、読みにくいSQLを短時間で整理できます。
可読性が向上するとレビュー・保守・障害対応すべての効率が上がります。
特に実務では「動くSQL」より「読めるSQL」が重要です。
オンラインFormatterやVS Code拡張を活用し、SQL整形を作業習慣にすることをおすすめします。
