// 免費工具

BigQuery SQL 格式化工具

在瀏覽器中格式化 BigQuery 的 GoogleSQL。反引號資料表路徑、查詢參數、陣列和 QUALIFY 都會完整保留並排版整齊。

格式化工具以 MySQL 規則讀取 BigQuery SQL,再加上下列列出的 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` 是一個加了引號的名稱,包括所有連字元。
  • 查詢參數。 @event 具名參數會被視為單一標記。
  • 陣列保持原樣。 [1, 2, 3] 字面值和 arr[OFFSET(0)] 下標會完全按照你輸入的方式保留, UNNEST, STRUCT 和 ARRAY_AGG 呼叫的排版就和任何函式一樣。
  • QUALIFY 有自己的子句,排版方式如同 HAVING,而且 INTERVAL 和 OVER (PARTITION BY …) 會沿用你的關鍵字大小寫。
  • 註解與字串。 # 註解會被保留,雙引號文字是字串,而且 r'…' raw 和 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 或 展開 用於前置逗號及每行一個項目。 格式化工具文件 涵蓋了詳細資訊。

BigQuery 格式化工具常見問題

格式化工具如何讀取 BigQuery SQL?

採用其 MySQL 規則——與 BigQuery 共用反引號的識別碼引號、# 註解和雙引號字串。此外還認得 @參數、[ ] 陣列和 QUALIFY。

它會破壞我的反引號 project.dataset.table 名稱嗎?

不。用反引號括起來的路徑對格式化器來說是單一名稱,因此會完全按照原樣保留。

我的 SQL 會被傳送到伺服器嗎?

不會。該格式化工具已編譯為 WebAssembly,並在你的瀏覽器分頁中執行。你的 SQL 永遠不會被上傳、記錄或儲存,一旦頁面載入,它就能離線運作。

格式化會破壞我的查詢嗎?

它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。

我可以與團隊共用我的格式化設定嗎?

是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。

// 格式化只是最基本功能

喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧

原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。