理解しなければならないクエリは、たいてい自分が書いたものではありません。ログから、ORMから、同僚のメッセージから来ます。1行、4つのjoin、そして終わりの見えないwhere。このページはそれを行に分けて形を見えるようにし、他の何かが読む必要が出れば1行に戻します。

使い方

1. 1 クエリを貼り付けます。1文でもスクリプト全体でも構いません。
2. 2 字下げを選び、整形かminifyを押します。
3. 3 文字は同じ枠の中で変わります。コピーするか、元に戻すを押してください。

1行のコメントは、行がなくなると危険になる

「--」のコメントは行末まで効きます。minifyは改行を取り除くので、そのまま残したコメントは後続をすべて飲み込みます。クエリは動きますが、黙って途中で終わるだけです。だからここでのminifyは行コメントを完全に取り除きます。そして文字列の中の「--」はそのまま残します。そこではそれはデータであって、コメントではないからです。

引用符と、二重ねの引用符

SQLでは、文字列の中の引用符は二重ねで書いて逃がします。'O''Brien'。2つめの引用符で文字列を閉じてしまうツールは、名前の残りをコードとして読み、そこから先で見つける予約語はすべて幻です。引用符付きの識別子も同じです。`order`、"group"、[limit] は名前であり、名前の中の予約語は予約語ではありません。

クエリを書き換えることはしない

予約語を大文字にせず、括弧を簡略化せず、別名も付け替えません。動くのは空白だけです。これは大事なことです。整形したクエリはたいてい、チームがレビューするファイルへ戻っていくからです。大小文字の変更で埋まった差分は、本当に変わった1行を隠してしまいます。小文字の予約語は流儀であって、誤りではありません。

整えることは、確かめることではない

このページはデータベースにつながることがありません。ですから、あるテーブルが存在するのか、joinが正しいのか、そのクエリが遅いのかは分かりません。読むのは文字で、動かすのは空白です。差し出せるのは形です。形の見えるクエリこそ、筋道を立てて考えられるクエリです。