「整形は見た目の問題で、動けば同じ」と思われがちですが、整形されていないSQLは、実際のバグにもつながります。本記事では、具体的にどのようなミスが起きやすいかを整理します。
WHERE句に複数の条件がANDとORで混在していると、意図した組み合わせになっているかが分かりにくくなります。
WHERE status = 'active' AND age >= 20 OR role = 'admin'
これは「(status = 'active' AND age >= 20) OR role = 'admin'」と解釈されます。「statusがactiveで、かつage20以上、または管理者」という意図であればこの書き方で正しいですが、1行に詰め込まれていると、書いた本人以外がこの優先順位を正確に読み取るのは簡単ではありません。整形してかっこを明示すれば、誤読を防げます。
複数のJOINが1行、あるいは改行なしで続けて書かれていると、どの条件がどのJOINに対応しているかを追うのが難しくなります。結合条件を1つ見落としたまま実行すると、意図しない行数の結果(重複行や欠落)が返ってくることがありますが、SQL自体はエラーにならないため、気づかないまま本番で使われてしまうことがあります。
デバッグのために一部の条件をコメントアウトする際、整形されていないSQLでは、コメントの範囲と実際に無効化したい条件の範囲がずれてしまうことがあります。句ごとに改行されていれば、コメントアウトする行の範囲が明確になります。
SQLをコードレビューする際、整形されていないSQLでは、1行の変更が「どの条件を変えたのか」を把握しづらくなります。句ごとに改行されたSQLであれば、差分(diff)上でも、変更された行だけが明確に表示され、レビューの負担が減ります。
SQLの整形は、見た目を整えるだけの作業ではありません。条件の優先順位、JOINの範囲、変更箇所を正確に伝えるための、実務上の安全策です。特に、他人が書いたSQLを確認するとき、あるいは長期間運用されているSQLを修正するときほど、整形されているかどうかの差が大きく効いてきます。
整形されていないSQLは、ANDとORの優先順位の誤読、JOINの範囲の見落とし、レビューのしづらさなど、具体的なリスクにつながります。整形のルールはSQLを読みやすく整形するルールで解説しています。
SQL整形ツールに貼り付けるだけで、これらのルールに沿った整形ができます。