// 無料のツール

PostgreSQL フォーマッター

ブラウザー上で PostgreSQL をフォーマットします。キャスト、ドル引用符付きの本体、JSONB 演算子、配列は Postgres と同じ方法で読み取られるため、フォーマッターが変更するのは空白と、指定した大文字小文字のみです。

.sql ファイルをここにドロップすると開きます。読み込むのはブラウザーの中だけで、アップロードはされません。

フォーマット後の SQL
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

Loading the formatter…

エディターのショートカット: Ctrl+Enter フォーマットと Ctrl+Shift+Enter ミニファイします(⌘ 代わりに Ctrl Mac では)。設定はこのブラウザに記憶され、ページのアドレスにも保存されるため、リンクで共有されるのはスタイルだけで、SQL は共有されません。

フォーマッターが PostgreSQL SQL に対して行うこと

  • 演算子は、Postgres が読むのと同じ見方で読み取られます。 PostgreSQL は、演算子文字の連続を 1 つの演算子として扱い、フォーマッターも同様です: ->>, #>>, @>, <@, ?|, || そして独自のカスタム演算子は決して分割されません。一方 x>=-1 引き続き次として読み取られます x >= -1.
  • キャストと配列はそのまま保持されます。 created_at::date コンパクトなままで、 ARRAY['a','b'], tags[1], tags[2:3] そして text[] は書かれたとおりそのまま保たれます。
  • ドル引用符で囲まれた本体は変更されません。 …の本体 $$ … $$ または $tag$ … $tag$ 関数などの文字列、または DO ブロックは、入れたとおりにそのまま出力されます。
  • パラメーターとリテラルはそのまま残ります。 $1 プレースホルダー、psql :variables, E'…' エスケープ文字列、 B'…' そして X'…' ビット文字列と U&'…' Unicode 文字列はそれぞれ 1 トークンです。
  • 大文字・小文字を保持する引用符付け。 PostgreSQL は、引用符のない名前を小文字に変換するため、 不要な引用符を削除 すでに大文字になっている名前だけ引用符を外します。最小化では次のものを保持します "Users" 引用符は保持されます。
  • Postgres のキーワードは、指定した大文字小文字がそのまま適用されます、次を含みます RETURNING, ILIKE, LATERAL, INTERVAL '7 days' そして NULLS LAST.

知っておくと便利なこと

  • 関数本体内の SQL はフォーマッターにとって文字列なので、再フォーマットされず、書かれたまま保持されます。

例

PostgreSQL のビフォーアフター

前
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
次の後
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

出力は、上のフォーマッターが生成するのとまったく同じ、4 スペース インデントの「標準」スタイルです。スタイルを切り替えるには、 コンパクト より高密度な SQL または 展開済み 先頭カンマと 1 行 1 項目にします。 フォーマッターのドキュメント 詳細を説明しています。

PostgreSQL フォーマッターの FAQ

PostgreSQL フォーマッターは ->> や @> などの JSONB 演算子を壊しませんか?

いいえ。PostgreSQL と同じように演算子を読み取り、演算子文字の連続を 1 つの演算子として扱うため、->>、#>>、@>、<@、?| やカスタム演算子が分割されることはありません。出力が同じ SQL としてトークン化されない場合は、入力をそのまま返します。

$$ で囲まれた関数本体を整形しますか?

いいえ。ドル引用符で囲まれた本体は文字列リテラルであり、フォーマッターは文字列の内部を変更しません。その外側の CREATE FUNCTION 文は引き続き整形されます。

「MixedCase」の名前から引用符は削除されますか?

要求したときだけ、しかも安全な場合に限ります。PostgreSQL は引用符なしの名前を小文字にするため、「不要な引用符を削除」は、すでに小文字で、かつキーワードではない名前の引用符だけを外します。

入力した SQL はサーバーに送信されますか?

いいえ。フォーマッターは WebAssembly にコンパイルされ、お使いのブラウザータブ内で実行されます。SQL がアップロード、記録、保存されることはなく、ページを読み込んだ後はオフラインでも動作し続けます。

整形でクエリが壊れることはありますか?

そうならないように作られています。整形後、SQLly は出力を入力とトークン単位で照合します。空白と指定した大文字・小文字以外が変わってしまう場合は、SQL を書いたとおりのまま返し、その理由を伝えます。終端されていない文字列のように正しく解析できない SQL も、問題の行と列を示したうえで、そのまま変更しません。

整形設定をチームで共有できますか?

はい。詳細設定を含むすべての設定は、ページのアドレスの # 記号の後ろに保持されるため、アドレスをコピーするか「設定リンクをコピー」を押せば、そのスタイルをそのまま共有できます。リンクに含まれるのは設定だけで、SQLは含まれません。

// フォーマットは序の口

フォーマッターは気に入りましたか?SQLly のほかの機能もどうぞ

macOS、Windows、Linux 用のネイティブ SQL ワークベンチ。スキーマを把握する IntelliSense、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。