重點摘要
- 01支援 PostgreSQL、MySQL、SQLite、BigQuery 和標準 SQL，具有方言感知的關鍵字處理。
- 02選擇關鍵字大小寫（大寫、小寫或保留）和縮排（2 個空格、4 個空格或製表符）。
- 03完全在您的瀏覽器中執行 — 包含敏感資料的查詢永遠不會離開您的裝置。
- 04該工具只重新格式化文字；它不執行查詢或連接到任何資料庫。
為什麼在分享之前要格式化 SQL？
未格式化的 SQL 確實很難審查。長 SELECT 列表壓成一行、子查詢中的縮排不一致以及混合大小寫的關鍵字都會減慢程式碼審查和除錯的速度。格式正確的查詢會立即使 JOIN 條件、WHERE 子句和 CTE 結構可讀。
當與具有樣式指南的團隊分享查詢時，格式化變得更加重要 — 大寫關鍵字、四空格縮排、每行一個子句。Handytool 的 SQL 格式化工具在您貼上的所有內容中一致地強制執行該樣式，無論是兩行查找還是包含多個 CTE 和視窗函式的 200 行分析查詢。
如何格式化 SQL 查詢
- 01
貼上您的 SQL
將任何 SQL 陳述式貼到輸入面板 — SELECT、INSERT、UPDATE、DELETE、CREATE 或完整的 CTE 鏈。除了瀏覽器的可用記憶體外，沒有大小限制。
- 02
選擇方言
從下拉清單中選擇 PostgreSQL、MySQL、SQLite、BigQuery 或標準 SQL。方言決定了如何處理保留字和供應商特定的語法（例如 RETURNING 或 STRUCT）。
- 03
設定關鍵字大小寫和縮排
為關鍵字大小寫選擇 [大寫]、[小寫] 或 [保留]。為縮排選擇 2 個空格、4 個空格或製表符。大寫關鍵字搭配 2 空格縮排是共享程式碼庫中最常見的樣式。
- 04
點擊 [格式化]
格式化的輸出立即出現在右側面板中。子句放在自己的行上，JOIN 條件對齊，子查詢相對於其父項縮排。
- 05
複製並使用
點擊 [複製] 將格式化的 SQL 複製到剪貼簿。貼到您的 IDE、SQL 檔案、PR 說明或文件片段。
可安全用於生產查詢模式
sql-formatter 程式庫完全在您的瀏覽器中執行。不會向伺服器傳送任何內容 — 無查詢文字、無表名、無範例資料。這使得格式化參考真實結構描述名稱或包含來自登陸資料庫的範例值的查詢是安全的。
格式化工具不會執行的一件事是執行您的 SQL。它只是一個文字轉換工具。您可以安全地貼上會刪除表或刪除行的查詢 — 該工具將其視為純文字並重新格式化，而不會執行任何陳述式。
SQL 格式化工具常見問題
此格式化工具支援哪些 SQL 方言？
標準 SQL、PostgreSQL、MySQL、SQLite 和 BigQuery。每種方言正確處理供應商特定的語法，如 PostgreSQL 的 RETURNING 子句、MySQL 的反引號識別碼和 BigQuery 的 STRUCT 類型。
格式化工具會執行我的查詢嗎？
不會。它只重新格式化查詢文字。它不連接到任何資料庫、驗證列名或執行陳述式。
我的 SQL 上傳到任何伺服器嗎？
不會。sql-formatter 程式庫在您的瀏覽器中執行。您的查詢文字留在您的裝置上。
為什麼我的預存程序或 PL/pgSQL 區塊格式化得不對？
程序 SQL 區塊（PL/pgSQL、BEGIN…END 區塊、DECLARE 區段）超出了格式化工具的語法覆蓋範圍。分別格式化來自這些區塊中的較小 SELECT 或 DML 片段。
共享程式碼庫的最佳關鍵字大小寫是什麼？
大寫關鍵字是最廣泛採用的慣例 — 它們在視覺上將 SQL 結構與識別碼名稱分開。2 個空格或 4 個空格縮排是團隊偏好的問題。