// 無料のツール

BigQuery SQL フォーマッター

ブラウザー上で BigQuery 向けの GoogleSQL をフォーマットします。バッククォートで囲んだテーブルパス、クエリパラメーター、配列、QUALIFY はそのまま保たれ、きれいに整形されます。

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

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

フォーマット後の SQL
SELECT
    user_id,
    COUNT(*) AS sessions,
    ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
    `my-project.analytics.events`
WHERE
    event_name = @event
    AND 'beta' IN UNNEST(tags)
    AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
    user_id
QUALIFY
    ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100

Loading the formatter…

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

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

  • バッククォートで囲んだテーブルパス。 `my-project.analytics.events` はハイフンも含めて 1 つの引用符付き名前です。
  • クエリパラメーター。 @event 名前付きパラメータは単一のトークンとして読み込まれます。
  • 配列は書かれたまま維持されます。 [1, 2, 3] リテラルと arr[OFFSET(0)] 添字は入力したとおりに保持され、 UNNEST, STRUCT そして ARRAY_AGG 呼び出しは、他の関数と同じようにレイアウトされます。
  • QUALIFY には独自の句がある、次のようにレイアウトされます HAVING、そして INTERVAL そして OVER (PARTITION BY …) キーワードの大文字小文字の設定が適用されます。
  • コメントと文字列。 # コメントは保持され、二重引用符で囲まれたテキストは文字列で、 r'…' 生および b'…' bytesリテラルはプレフィックスに付いたままになります。

知っておくと便利なこと

  • キーワードの大文字・小文字変換は標準 SQL と MySQL のキーワードが対象のため、BigQuery 専用の語は入力したとおりの表記のままになります。

例

BigQuery の整形前と整形後

前
select user_id, count(*) as sessions, array_agg(page order by ts limit 5) as first_pages from `my-project.analytics.events` where event_name = @event and 'beta' in unnest(tags) and ts >= timestamp_sub(current_timestamp(), interval 7 day) group by user_id qualify row_number() over (order by count(*) desc) <= 100
次の後
SELECT
    user_id,
    COUNT(*) AS sessions,
    ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
    `my-project.analytics.events`
WHERE
    event_name = @event
    AND 'beta' IN UNNEST(tags)
    AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
    user_id
QUALIFY
    ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100

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

BigQuery フォーマッターの FAQ

フォーマッターは BigQuery SQL をどのように読み取りますか?

MySQL のルールを使用します。BigQuery とバッククォートによる引用、# コメント、二重引用符の文字列が共通しているためです。そのうえで @parameters、[ ] 配列、QUALIFY も解釈します。

バッククォートで囲んだ project.dataset.table 名は壊れますか?

いいえ。バッククォートで囲まれたパスはフォーマッターにとって 1 つの名前なので、書かれたとおりに保持されます。

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

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

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

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

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

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

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

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

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