Snowflake SQL 格式化工具
在瀏覽器中格式化 Snowflake SQL。半結構化路徑、型別轉換、QUALIFY 和視窗函式排版整齊,語意不變。
格式化工具以 PostgreSQL 規則讀取 Snowflake SQL,再加上下列列出的 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:sku會保持寫成單一運算式。 - QUALIFY 有自己的子句。
QUALIFY排列如下HAVING,而且OVER (PARTITION BY … ORDER BY …)會沿用你的關鍵字大小寫。 - 轉換與函式。
::轉型保持精簡,而且LATERAL FLATTEN(input => …)具名引數會照原樣保留。 - 美元引號括住的內容保持原樣,所以一個
$$ … $$程序或 UDF 內容會完全原樣輸出。
小知識
- 像這樣的 stage 參照
@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 或 展開 用於前置逗號及每行一個項目。 格式化工具文件 涵蓋了詳細資訊。
Snowflake 格式化工具常見問題
格式化工具如何讀取 Snowflake SQL?
採用其 PostgreSQL 規則,與 Snowflake 共用引號慣例、:: 轉型和 $$ 字串。此外還會把 col:path 這種存取寫在一起不拆開,並把 QUALIFY 當成一個子句排版。
為什麼它對我的 COPY INTO 陳述式原封不動?
像 @my_stage 這類 stage 參照目前尚不支援,因此包含這類參照的 SQL 會原樣傳回,並附上註記說明格式化器停在何處。
我的 SQL 會被傳送到伺服器嗎?
不會。該格式化工具已編譯為 WebAssembly,並在你的瀏覽器分頁中執行。你的 SQL 永遠不會被上傳、記錄或儲存,一旦頁面載入,它就能離線運作。
格式化會破壞我的查詢嗎?
它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。
我可以與團隊共用我的格式化設定嗎?
是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。
喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧
原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。