このページは Dev Tools Suite で SQL を整形・minify する正規ガイドです。読みながら上の SQL Formatter を使うか、下のセクションにジャンプしてください。解析と整形はブラウザ内の sql-formatter で実行され、クエリ・スキーマ名・サンプルデータはサーバーにアップロードされません。

SQL Formatter は人間向けに複数行 SQL を beautify し、転送向けに minify します。キーワードを自動で大文字化（SELECT, FROM, WHERE）し、句を意識したインデントを適用し、sql-formatter ライブラリの方言別文法に従います — 多くの IDE 拡張や CLI フォーマッタと同じエンジンです。

得られるもの

• 対称デュアルペイン: 左に SQL 入力、右に整形または minify 出力
• コアリレーショナル、クラウドウェアハウス、ビッグデータ、エンタープライズに分類された 13 方言パーサー
• Beautify / Minify モード、ライブ自動整形（デバウンス）、明示的 Process ボタン
• パネルヘッダーの方言ピッカーと Strip comments — エディタ高さを奪う余分行なし
• 大きな SELECT ツリー向け折りたたみ出力（Beautify）
• 方言パーサーが読めないときの行・列ヒント付きパースエラー
• 任意の URL 共有: ?mode=minify&dialect=postgresql でモードと方言を保持

このツールを使う場面

• ログ、BI、ORM からの即席 SQL をレビュー前に読みやすくしたい
• アプリコードに埋め込む 1 行 minify 文字列が欲しい
• PostgreSQL、Snowflake、BigQuery、Spark、Oracle で方言キーワードを認識させたい
• コミットや送信前にブロック・行コメントを除去したい

期待しないこと

• 意味的検証 — 整形成功はサーバー実行成功を意味しない
• 自動クエリ計画、パフォーマンス lint、スキーマ認識リライト
• 選択方言でカバーされないベンダー拡張の完全保持
• サーバー側 EXPLAIN や実行 — レイアウトと空白のツールのみ

コントロールは SQL QUERY パネルヘッダーにあり、入出力エディタの高さを揃えます。ツールバー下に別オプション行はありません。

キーボードショートカット

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — ワークスペースをクリア

実行環境に合う方言を常に選んでください。パーサーは方言ごとにキーワード、関数名、コメント規則が異なります。汎用 ANSI 断片には Standard SQL が安全なデフォルトです。

Cassandra CQL は非対応 — sql-formatter 方言セットに含まれません。Cassandra には CQL 専用フォーマッタを使用してください。

Beautify と Minify は同じ方言ピッカーと Strip comments を共有しますが、出力形状が異なります。

例

入力: select id, name from users where active = 1 — Beautify は SELECT / FROM / WHERE 大文字のインデント行を生成。Strip オフの Minify は 1 行: select id, name from users where active = 1。

1. サイドバーの Formatters から SQL Formatter を開く。
2. 左エディタに SQL を貼り付け、セッションツールバーから .sql をアップロード、または空状態にドラッグ＆ドロップ。
3. データベースに合う方言を選択（例: Snowflake ワークシートなら snowflake）。
4. 出力に不要な -- や /* */ がある場合は Strip comments をオン。
5. 読みやすい SQL は Beautify、コンパクト 1 行は Minify。
6. 右の出力を確認。パースエラーバナーを修正 — 編集後クリックで閉じる。
7. コピー、ダウンロード、または出力を入力にスワップして再実行。
8. 同じ設定を共有するには ?dialect=bigquery&mode=minify のリンクを共有。

Flyway、Liquibase、ORM のマイグレーションファイルは、SELECT リスト、JOIN、WHERE が一貫した行に分かれるとレビューしやすくなります。

ワークフロー

1. マイグレーション先に合わせ postgresql、transactsql、mysql、sqlite を設定。
2. 生成 diff や ORM 出力から生のマイグレーション SQL を貼り付け。
3. 意図を示すインラインコメントがある場合は Strip オフで Beautify。
4. PR 前に整形 SQL をマイグレーションファイルに戻す。

ヒント

整形はライブスキーマを検証しません。見た目変更後はステージング DB でマイグレーションを実行してください。

アナリティクスエンジニアは Snowflake、BigQuery、Redshift コンソールから大文字小文字や改行が不揃いな SQL をよくコピーします。

Snowflake / BigQuery / Redshift

• ウェアハウス関数を正しくパースするため Beautify 前に snowflake、bigquery、redshift を選択。
• ノートブックの -- セッションメモを含むエクスポートでは Strip comments を使用。
• 非常に広い SELECT リストは Beautify 後に Expand all / Collapse all を使用。

Spark / Trino / Hive

• Databricks ノートブックと Spark SQL パイプラインには spark。
• カタログ横断の Presto 互換連合クエリには trino。
• レガシー HiveQL には hive — カバレッジは sql-formatter Hive 方言規則に従う。

アプリコードは SQL をテンプレート文字列として保持することが多いです。Minify は JavaScript、Python、Go 内の 1 行向けにバイトとエスケープを削減します。

1. 読みやすい SQL を入力パネルに貼り付け。
2. デバッグメモが残っていれば Strip comments を有効化。
3. Minify モードに切り替え。
4. 1 行出力を文字列リテラルにコピー（言語ごとのクォートエスケープに注意）。

ソースでは読みやすく実行時はコンパクトにしたい場合、beautify 版をドキュメントに残し、ビルド成果物だけ minify してください。

レビュー前に SQL を正規化し、差分がロジックに集中するようにします。

• チケットに 1 行 SQL が貼られた比較では両側を beautify。
• 大文字キーワードを一貫スタイルに — Beautify で自動適用。
• 2 版を整形後 Text Diff にパイプして意味的なクエリ差分が必要な場合。

Strip comments は Beautify と Minify の両方に適用されます。オン時は実装されている方言対応規則で整形前にコメントを削除します。

Strip オフ時（Minify）

Minify は 1 行に空白を圧縮しますがコメント本文は残します。コメントをクエリと一緒に送る場合に使用。

パーサー失敗時、赤バナーに行・列付き Parse error が表示されます。利用可能なら入力エディタがエラー行をハイライトします。

よくある修正

1. 方言不一致 — 実際のエンジンに切り替え（Oracle パッケージは plsql、Standard SQL ではない）。
2. 未閉じ文字列や括弧 — 報告行付近でクォートと括弧を整合。
3. 末尾カンマや未完成句 — SELECT リストと CTE を完成してから整形。
4. 非 SQL が貼られた — クエリ周りのシェルや JSON ラッパーを除去。
5. 汎用モードでの方言固有構文 — ベンダー方言を試すか未対応拡張を簡略化。

有効なクエリがまだ失敗する場合、その構文変種を sql-formatter がカバーしていない可能性があります。上流に報告するか簡略部分を手動整形してください。

SQL Formatter は 100% ブラウザ内で動作します。sql-formatter ライブラリは動的ロードされ、メインスレッドの JavaScript で整形します。

• クエリ本文は Dev Tools Suite サーバーに送信されない
• 入力、出力、方言、Strip comments 設定はデバイスの localStorage に保存可能
• URL クエリ（?dialect=、?mode=）は設定のみ — SQL 本文は含まない
• 本番データや PII 作業後はワークスペースをクリア（Ctrl/Cmd+L）

• Beautify 前に実行環境と方言を一致 — 整形成功 ≠ 実行成功
• 人間向け Beautify、機械向け Minify
• ビジネスルールをコメントで残すときは Strip オフ、エクスポートと埋め込みではオン
• ドルクォートや特殊リテラルがある minify 出力はステージングで検証
• 大きなスクリプトはチャットアプリへの貼り付けではなくセッション履歴とファイルアップロードを使用
• 同じレポートクエリの 2 整形版比較には Text Diff と組み合わせ