// 無料のツール

Snowflake SQL フォーマッター

ブラウザー上で Snowflake SQL をフォーマットします。半構造化データのパス、キャスト、QUALIFY、ウィンドウ関数が、意味はそのまま整ったレイアウトで出力されます。

フォーマッターは Snowflake SQL を PostgreSQL のルールで読み、以下に挙げた Snowflake 固有の構文にも対応します。

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

フォーマット後の 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:sku 1つの式として書かれたまま保たれます。
  • 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、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。