BigQuery SQL フォーマッター
ブラウザー上で BigQuery 向けの GoogleSQL をフォーマットします。バッククォートで囲んだテーブルパス、クエリパラメーター、配列、QUALIFY はそのまま保たれ、きれいに整形されます。
フォーマッターは BigQuery SQL を MySQL のルールで読み、以下に挙げた BigQuery 固有の構文にも対応します。
フォーマッターのすべてのレイアウト設定を、次のようにグループ化しています エディター › 書式設定 SQLly アプリ内で。上のスタイルが出発点で、ここで変更したものにはマークが付きます。
.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、危険なクエリへのガードレール、エディターに組み込まれたこのフォーマッターを備えています。