PostgreSQL 格式化工具
在瀏覽器中格式化 PostgreSQL。型別轉換、美元引號區塊、JSONB 運算子和陣列都會以 Postgres 的方式解讀,因此格式化工具只會調整空白,以及你指定的大小寫。
格式化器的每個版面配置設定,按群組分類 編輯器 › 格式化 在 SQLly 應用程式中。上方的樣式是起點;你在此處更改的任何內容都會被標記。
將 .sql 檔案拖到這裡以開啟。它會在你的瀏覽器中讀取,而不是上傳。
SELECT
id,
payload ->> 'kind' AS kind,
payload #>> '{user,id}' AS user_id,
tags[1] AS first_tag
FROM
events
WHERE
tags @> ARRAY['beta']::TEXT[]
AND payload ? 'source'
AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
created_at DESC NULLS LAST
LIMIT 50;
Loading the formatter…
編輯器中的快速鍵: Ctrl+Enter 鍵 會進行格式化,而 Ctrl+Shift+Enter 鍵 縮小(⌘ 而不是 Ctrl 在 Mac 上)。你的設定會記在這個瀏覽器裡,並保存在頁面位址中,所以分享連結帶的是你的樣式 —— 絕不會是你的 SQL。
格式化工具對 PostgreSQL SQL 的處理方式
- 運算子的讀取方式與 Postgres 一致。 PostgreSQL 會把連續的運算子字元視為單一運算子,格式化工具也是如此:
->>,#>>,@>,<@,?|,||而你自訂的運算子也永遠不會被拆散,而x>=-1仍然讀作x >= -1. - 轉換和陣列原樣保留。
created_at::date保持緊湊,而且ARRAY['a','b'],tags[1],tags[2:3]和text[]完全照原樣保留。 - 美元引號括住的內容不會被更動。 主體來自
$$ … $$或$tag$ … $tag$字串,例如函式或DO區塊,出來時和進去時一模一樣。 - 參數和字面值會原封不動地保留。
$1佔位符、psql:variables,E'…'跳脫字串,B'…'和X'…'位元字串和U&'…'每個 Unicode 字串都各是一個詞元。 - 用引號保障大小寫。 PostgreSQL 會把未加引號的名稱轉為小寫,所以 移除不必要的引號 只會對已經是小寫的名稱取消引號。
"Users"會保留它的引號。 - Postgres 關鍵字會用你輸入的大小寫,包括
RETURNING,ILIKE,LATERAL,INTERVAL '7 days'和NULLS LAST.
小知識
- 函式體內的 SQL 對格式化器來說是字串,因此它會按原樣保留,而不是重新格式化。
範例
PostgreSQL 前後對照
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
SELECT
id,
payload ->> 'kind' AS kind,
payload #>> '{user,id}' AS user_id,
tags[1] AS first_tag
FROM
events
WHERE
tags @> ARRAY['beta']::TEXT[]
AND payload ? 'source'
AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
created_at DESC NULLS LAST
LIMIT 50;
輸出使用標準樣式與 4 格空白縮排,和上面的格式化工具產出的完全一樣。把樣式切換到 緊湊 可用於更精簡的 SQL 或 展開 用於前置逗號及每行一個項目。 格式化工具文件 涵蓋了詳細資訊。
PostgreSQL 格式化工具常見問題
PostgreSQL 格式化工具會破壞 ->> 或 @> 這類 JSONB 運算子嗎?
不會。它像 PostgreSQL 一樣讀取運算子,將運算子字元視為連續的一段,因此 ->>, #>>, @>, <@, ?| 和自訂運算子永遠不會被拆開。如果其輸出無法解析為相同的 SQL,則會原樣傳回你的輸入。
它會重新格式化 $$ 引號之間的函式主體嗎?
不會。以美元符號括起的主體是字串常值,格式化器從不更動字串內部。包在外面的 CREATE FUNCTION 陳述式仍會照常排版。
它會移除「MixedCase」名稱上的引號嗎?
僅在你要求時,且僅在安全的情況下。PostgreSQL 會將未加引號的名稱轉為小寫,因此「移除不必要的引號」僅會去掉已經是小寫且不是關鍵字的名稱的引號。
我的 SQL 會被傳送到伺服器嗎?
不會。該格式化工具已編譯為 WebAssembly,並在你的瀏覽器分頁中執行。你的 SQL 永遠不會被上傳、記錄或儲存,一旦頁面載入,它就能離線運作。
格式化會破壞我的查詢嗎?
它的設計就是不會。格式化之後,SQLly 會將輸出與你的輸入逐個 token 比對,如果除了空白與你指定的大小寫之外還有任何改變,它會把你的 SQL 原樣退回,並告訴你原因。無法順利解析的 SQL,例如未結束的字串,也會保持原樣,並指出問題所在的行與欄。
我可以與團隊共用我的格式化設定嗎?
是的。包括進階設定在內的每一項設定,都會保存在網址 # 號之後,複製網址或按「複製設定連結」就能分享你確切的樣式。連結只保存設定,絕不包含你的 SQL。
其他方言
- 任何方言(自動偵測)
- SQL Server 格式化工具(T-SQL)
- MySQL 格式化工具
- SQLite 格式化工具
- Oracle SQL 格式化工具
- Snowflake SQL 格式化工具
- BigQuery SQL 格式化工具
- Redshift SQL 格式化工具
每天都在使用 PostgreSQL 嗎?看看 SQLly 桌面應用程式為 PostgreSQL 做了什麼,或瀏覽所有 功能.
喜歡這個格式化工具嗎?來看看 SQLly 的其他功能吧
原生 SQL 工作台,支援 macOS、Windows 和 Linux,IntelliSense 認得你的結構描述,高風險查詢有防護,這套格式化工具也內建在編輯器裡。