SQLの整形について

SQLは、たいてい1本の長大な行としてやってきます。ORMのログから、バグ報告から、誰かのクリップボードから。問題なく動くのに、まったく読めません。そして探している箇所は、その真ん中のどこかにあります。

貼り付ければ、組み上がった形で返ってきます。 1句1行、SELECTの下に列をインデント、JOINとそのON条件をそろえて並べるので、クエリの形が一目で見えます。

使い方

整形のために押すボタンはありません。結果を変えるボタンは整形と1行に圧縮の2つだけで、

これはどちらを表示するかを選ぶものです。

出力の色分けは、整形したのと同じトークナイザを仕上がったテキストにもう一度走らせて付け

ています。キーワードはシアン、文字列は黄、数値はオレンジ、コメントは灰、記号はピンク、そし

てあなたのテーブル名や列名は素のままにして、まわりのSQLから浮かび上がるようにしています。

これは見た目以上の意味があります。クエリを一度読み取った結果がレイアウトと色の両方を作るの

で、二つが食い違うことはありえません。文字列として塗られているものは、整形側も確かに文字列

として扱ったものです。どこかで引用符が閉じていなければ、色がそのまま流れて位置を教えてくれ

ます。たいていは目で探すより速い方法です。

コピーとダウンロードが渡すのはプレーンテキストです。 色付きのマークアップではありません。

手早いSQL整形ツールの多くは正規表現で動いており、この2点こそ、その方式が崩れるところです。

文字列とコメントの中は決して見ません。 WHERE note = 'from a, b'を含むクエリには、文字列リテラルの中にキーワードとカンマと空白があります。正規表現の整形はそこで行を折り、クエリの意味を変えてしまいます。この道具はまずクエリをトークンに読み取るので、リテラルの中身は空白まで含めて入ったとおりに出ていきます
識別子は書いたままの大文字小文字を保ちます。 大文字小文字を変えるのはキーワードだけです。大文字小文字を区別するサーバーではuserIdとuseridは別の列であり、それを「整えて」しまう整形ツールは、見た目のためにクエリを壊したことになります

引用のしかたはすべて理解します。''でエスケープする'文字列'、"引用符付き識別子"、MySQLのバッククォート、SQL Serverの[角かっこ]、PostgreSQLの$$ ドル引用 $$。

圧縮すると、クエリは1行に戻ります。空白は、取り除くと意味が変わる場所や新しいトークンができてしまう場所にだけ残すので、安全な範囲でいちばん短くなります。

行コメントは落とされます。すべてが1行になると-- このようなコメントが残りを飲み込んでしまうからです。ブロックコメントは書かれたとおりに残ります。