任務路徑 / 從輸入到結果
如何在不執行查詢的情況下格式化 SQL
- 01
選擇 SQL 方言
選擇標準 SQL、PostgreSQL、MySQL、SQLite、SQL Server、BigQuery 或 Snowflake,讓方言特有語法得到正確解析——預設是 PostgreSQL。這裡沒有自動辨識:請選擇你的資料庫實際使用的方言,因為在標準 SQL 下能正常格式化的子句,換成正確的方言後關鍵字歸屬可能不同。
- 02
貼上後立即格式化
貼上或輸入最多 256 KiB 的 SQL。貼上會立即執行;開啟自動格式化時,普通輸入會在短暫停頓後重跑;也可按 Ctrl 或 Command + Enter 按需套用目前選項。工作區預置了一段包含聯結的範例查詢,可以先觀察格式化效果,再交給它處理正式環境的 SQL。
- 03
選擇易讀或精簡輸出
壓縮保留換行、註解、字面值與詞法單元間的分隔。PostgreSQL 假設 standard_conforming_strings=on,MySQL 假設預設反斜線跳脫;不會偵測資料庫工作階段設定。格式化會改變引號內容、註解或字面值之間的換行。請改用壓縮模式或調整 SQL;不會匯出部分結果。
- 04
檢查結果和位元組數
輸出面板隨每次執行更新,頁尾會報告精確的輸入和輸出位元組數,讓易讀性的成本——或壓縮帶來的節省——一目瞭然。執行在 Web Worker 中運行,審核後的預算為 1,500 毫秒;格式化輸出上限為 512 KiB;分詞器無法處理的語句會停止並標明行列位置。
- 05
檢查、複製或下載
依實際資料庫版本檢查結果,然後複製到剪貼簿或下載為 toolars-formatted.sql 檔。格式化不能取代資料庫驗證:工作區從不連線資料庫,物件名、權限和語意請在查詢真正執行的環境中確認。取消會停止執行並關閉自動格式化,保留 SQL。修改 SQL 或選項會清除先前的輸出。