PostgreSQL フォーマッター
ブラウザー上で PostgreSQL をフォーマットします。キャスト、ドル引用符付きの本体、JSONB 演算子、配列は Postgres と同じ方法で読み取られるため、フォーマッターが変更するのは空白と、指定した大文字小文字のみです。
フォーマッターのすべてのレイアウト設定を、次のようにグループ化しています エディター › 書式設定 SQLly アプリ内で。上のスタイルが出発点で、ここで変更したものにはマークが付きます。
.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は含まれません。
その他の方言
- 任意の方言(自動検出)
- SQL Server フォーマッタ (T-SQL)
- MySQLフォーマッター
- SQLite フォーマッタ
- Oracle SQL フォーマッター
- Snowflake SQL フォーマッター
- BigQuery SQL フォーマッター
- Redshift SQL フォーマッター
PostgreSQL を毎日使っていますか? 詳しくは SQLly デスクトップアプリが PostgreSQL でできること、またはすべての 機能.
フォーマッターは気に入りましたか?SQLly のほかの機能もどうぞ
macOS、Windows、Linux 用のネイティブ SQL ワークベンチ。スキーマを把握する IntelliSense、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。