Snowflake SQL フォーマッター
ブラウザー上で Snowflake SQL をフォーマットします。半構造化データのパス、キャスト、QUALIFY、ウィンドウ関数が、意味はそのまま整ったレイアウトで出力されます。
フォーマッターは Snowflake SQL を PostgreSQL のルールで読み、以下に挙げた Snowflake 固有の構文にも対応します。
フォーマッターのすべてのレイアウト設定を、次のようにグループ化しています エディター › 書式設定 SQLly アプリ内で。上のスタイルが出発点で、ここで変更したものにはマークが付きます。
.sql ファイルをここにドロップすると開きます。読み込むのはブラウザーの中だけで、アップロードはされません。
SELECT
o.order_id,
o.src:customer.name::string AS customer,
f.value:sku::string AS sku
FROM
raw_orders o, LATERAL FLATTEN(input => o.src:items) f
WHERE
o.loaded_at >= DATEADD(day, -1, CURRENT_TIMESTAMP())
QUALIFY
ROW_NUMBER() OVER (PARTITION BY o.order_id ORDER BY o.loaded_at DESC) = 1
Loading the formatter…
エディターのショートカット: Ctrl+Enter フォーマットと Ctrl+Shift+Enter ミニファイします(⌘ 代わりに Ctrl Mac では)。設定はこのブラウザに記憶され、ページのアドレスにも保存されるため、リンクで共有されるのはスタイルだけで、SQL は共有されません。
フォーマッターが Snowflake SQL に対して行うこと
- 半構造化データのパスが分割されなくなりました。
src:customer.name::stringそしてf.value:sku1つの式として書かれたまま保たれます。 - QUALIFY には独自の句があります。
QUALIFYは、次のように整形されますHAVING、そしてOVER (PARTITION BY … ORDER BY …)キーワードの大文字小文字の設定が適用されます。 - キャストと関数。
::キャストの前後は詰めたままになり、LATERAL FLATTEN(input => …)名前付き引数は記述されたまま保持されます。 - ドル引用符で囲まれた本体は変更されません、そのため
$$ … $$プロシージャや UDF の本体は、入力したとおりそのまま出力されます。
知っておくと便利なこと
- 次のようなステージ参照
@my_stage/path/はまだフォーマットされません。それを含むSQLは変更されずに返り、次を指す注記が付きます@. - キーワードの大文字・小文字変換は標準 SQL と PostgreSQL のキーワードが対象のため、Snowflake 専用の語は入力したとおりの表記のままになります。
例
Snowflake のビフォー・アフター
select o.order_id, o.src:customer.name::string as customer, f.value:sku::string as sku from raw_orders o, lateral flatten(input => o.src:items) f where o.loaded_at >= dateadd(day, -1, current_timestamp()) qualify row_number() over (partition by o.order_id order by o.loaded_at desc) = 1
SELECT
o.order_id,
o.src:customer.name::string AS customer,
f.value:sku::string AS sku
FROM
raw_orders o, LATERAL FLATTEN(input => o.src:items) f
WHERE
o.loaded_at >= DATEADD(day, -1, CURRENT_TIMESTAMP())
QUALIFY
ROW_NUMBER() OVER (PARTITION BY o.order_id ORDER BY o.loaded_at DESC) = 1
出力は、上のフォーマッターが生成するのとまったく同じ、4 スペース インデントの「標準」スタイルです。スタイルを切り替えるには、 コンパクト より高密度な SQL または 展開済み 先頭カンマと 1 行 1 項目にします。 フォーマッターのドキュメント 詳細を説明しています。
Snowflake フォーマッター FAQ
フォーマッターは Snowflake SQL をどのように読み取りますか?
Snowflake と共通の引用符、:: キャスト、$$ 文字列を持つ PostgreSQL のルールを使用します。そのうえで col:path アクセスをまとめて保持し、QUALIFY を句として整形します。
COPY INTO ステートメントがそのまま残されるのはなぜですか?
@my_stage などのステージ参照はまだサポートされていないため、それを含む SQL は書かれたままの形で返され、フォーマッターが処理をやめた箇所が注記で示されます。
入力した SQL はサーバーに送信されますか?
いいえ。フォーマッターは WebAssembly にコンパイルされ、お使いのブラウザータブ内で実行されます。SQL がアップロード、記録、保存されることはなく、ページを読み込んだ後はオフラインでも動作し続けます。
整形でクエリが壊れることはありますか?
そうならないように作られています。整形後、SQLly は出力を入力とトークン単位で照合します。空白と指定した大文字・小文字以外が変わってしまう場合は、SQL を書いたとおりのまま返し、その理由を伝えます。終端されていない文字列のように正しく解析できない SQL も、問題の行と列を示したうえで、そのまま変更しません。
整形設定をチームで共有できますか?
はい。詳細設定を含むすべての設定は、ページのアドレスの # 記号の後ろに保持されるため、アドレスをコピーするか「設定リンクをコピー」を押せば、そのスタイルをそのまま共有できます。リンクに含まれるのは設定だけで、SQLは含まれません。
フォーマッターは気に入りましたか?SQLly のほかの機能もどうぞ
macOS、Windows、Linux 用のネイティブ SQL ワークベンチ。スキーマを把握する IntelliSense、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。