SQL 格式化

讓 SQL 邏輯更容易理解

SQL 格式化程式重寫查詢版面，讓子句、連接、選取資料列、謂詞和排序更易於掃描。 它對於偵錯報告、審查遷移、記錄範例以及從日誌中理清單行查詢非常有用。

格式化應保留 SQL 邏輯，但方言有所不同。應在您實際使用的資料庫引擎中檢查特定於供應商的語法、流程區塊、帶有引號的識別碼、註解和異常運算子。

使用方法

1. 將 SQL 查詢貼到輸入編輯器中。
2. 點選 格式化 SQL 來排列子句和縮排。
3. 檢視格式化的 SQL 中保留的謂詞、連接、別名、註解和文字。
4. 使用 複製 作為剪貼簿，使用 下載 作為文件，或使用 清除 進行重設。

什麼是 SQL 格式化程式？

SQL 格式化 是一個基於瀏覽器的實用工具，用於提高 SQL 的可讀性。它將 SELECT、FROM、JOIN、WHERE、GROUP BY 和 ORDER BY 等主要子句分開，因此查詢意圖更清晰。

SQL 由資料庫執行，而不是由格式化程式執行。在提交之前，請始終對目標資料庫或測試套件執行重要的格式化查詢。

輸入說明

僅貼上 SQL 文字。首先刪除日誌前綴、計時輸出、shell 提示或應用程式字串轉義。將格式化的 SQL 複製回程式碼時，請記住特定於方言的語法。

範例

當列、連接和過濾器分開時，單行查詢變得更容易檢視：

--- 未格式化輸入 ---
SELECT u.name, u.email, o.total FROM users u JOIN orders o ON u.id=o.user_id WHERE o.total>100 ORDER BY o.total DESC;

--- 格式化輸出 ---
SELECT
  u.name,
  u.email,
  o.total
FROM users u
JOIN orders o ON u.id = o.user_id
WHERE o.total > 100
ORDER BY o.total DESC;

MCP 整合

MCP（Model Context Protocol，模型上下文通訊協定）讓 AI 代理和應用可以探索並呼叫 Coding.Tools 工具，用於可重複的轉換、格式化、雜湊和產生工作流程。

MCP 工具名稱: sql-formatter

MCP 端點: https://coding.tools/mcp

請先呼叫 tools/list。每個工具項目都包含 inputSchema、outputSchema 和 examples，AI 代理或用戶端可據此建立有效參數，不需要猜測。

呼叫 tools/call 後，result.content[0].text 是顯示用結果，result.structuredContent 是適合程式解析的結構化結果。工具層級失敗會回傳 isError: true；通訊協定層級失敗會回傳 JSON-RPC 錯誤。

tools/call 請求範例：

curl -s https://coding.tools/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"sql-formatter","arguments":{"input":"select id,total from invoices where paid = 1 order by total desc"}}}'

大多數文字與資料工具接受 input 字串以及可選的 options。只依賴瀏覽器圖片 API 的圖片工具會用於探索，並在需要瀏覽器能力時傳回網頁入口。