SQL美化格式化

SQL 美化與壓縮會改變哪些文字

把一長行 SQL 貼入後，可選擇「美化」重新安排子句換行與縮排，或選「壓縮」減少空白、換行，方便檢視或嵌入文字。輸出仍是 SQL 文字，可複製或下載；頁面也會顯示輸入與輸出的字元數、行數，壓縮模式另列長度變化比例。這項處理不連接資料庫、不讀取資料表，也不會執行查詢。

SQL 的關鍵字、識別字（資料表或欄位名稱）、字串常值與註解各有不同語法角色。選項中的關鍵字大小寫只作用於辨識到的關鍵字；Upper、Lower、Preserve 分別是轉大寫、轉小寫及盡量沿用原大小寫。這不是把所有字元一律轉換大小寫。PostgreSQL 與 MySQL 等方言對識別字與引號的規則不同，因此依語句原本要執行的資料庫選方言，會比只看排版結果重要。PostgreSQL 詞法結構文件與MySQL 名稱規則可查核這類差異；SQLite 也有自己的關鍵字清單。

先選資料庫，再整理 SQL

1. 指定方言

   選 Standard SQL、MySQL、PostgreSQL、MariaDB 或 SQLite。若程式實際連線特定資料庫，請依該資料庫選擇；方言清單未包含 Oracle、SQL Server、BigQuery 等其他選項。

2. 貼上查詢並挑模式

   在輸入區貼上 SQL，選美化或壓縮。美化適合閱讀、程式碼審查與文件展示；壓縮則偏向把空白與換行收整。空白輸入不會產生結果。

3. 調整美化外觀

   美化模式可用 2、4、8 個空格或 Tab 縮排，並設定關鍵字 Upper、Lower 或 Preserve。壓縮模式保留方言選項，但不顯示縮排與大小寫設定。設定變更後結果會重新整理。

4. 檢視後複製或下載

   比較結果中的子句、引號、註解、字串和欄位名稱；確認後複製文字，或下載 SQL 文字檔。錯誤訊息出現時，先檢查輸入是否完整、引號或括號是否成對，再縮小範圍重試。

用簡短查詢確認排版選項

例如輸入 SELECT id,name FROM users WHERE active=1 ORDER BY name;，用 Standard SQL、美化、2 個空格與 Upper，可得到依 SELECT、FROM、WHERE、ORDER BY 等結構重新分行的文字。把縮排改為 4 個空格只改變排版寬度；把關鍵字設成 Lower 則會把辨識到的 SELECT 等關鍵字改成小寫。實際格式取決於語句與方言，不應只憑這個簡例推斷複雜查詢的解析結果。

方言、壓縮與語法檢查常見問題

輸出前後都要留意的界線

SQL 排版完成只代表產生了文字結果，不代表 SQL 通過語法檢查、符合業務需求或安全無虞。

• 選錯方言可能使特殊引號、函式、型別轉換或程序片段呈現不理想，不能把支援方言視為資料庫版本相容保證。
• 壓縮會改變空白與換行；部分資料庫會賦予註解、提示或換行特定作用。對這些內容敏感的查詢，請逐段檢查輸出及目標資料庫設定。
• 不要因為格式化成功就直接執行 UPDATE、DELETE、DDL 或其他有影響的語句。先在適當環境檢查語法、條件和預期影響。
• SQL 可能包含內部表名、帳號、個人資料或業務條件；貼入前請依組織資料處理規範移除敏感資訊。