在將服務從 Microsoft SQL Server 遷移至 MySQL 的過程中，SQL 語句中的類型轉換往往是首個踩坑點。MySQL 的 CONVERT() 函數在數據類型名稱的相容性與參數順序上，均與 SQL Server 存在顯著差異，若不加注意極易導致遷移失敗或結果錯誤。

核心語法差異對照

SQL Server 寫法：

CONVERT(int, Port)

MySQL 寫法：

CONVERT(Port, SIGNED) AS `port`

• 參數順序顛倒： MySQL 將「被轉換的表達式」置於第一參數，「目標類型」置於第二參數。
• 類型關鍵字不同： SQL Server 使用 int，MySQL 則使用 SIGNED（或 UNSIGNED）來表示有符號/無符號整數。
• 別名不可省略： 若省略 AS `port`，結果集的列名將顯示為完整的函數呼叫 convert(Port, SIGNED)，嚴重影響可讀性與後續程式碼映射。

識別符號引用規則

SQL Server 使用方括號 [] 包裹含特殊字元或保留字的識別符；MySQL 則統一採用反引號（鍵盤 Esc 鍵下方、不按 Shift 的鍵），例如 `order`、`group`。

MySQL CONVERT() 支援的目標類型

轉換時的目標類型必須是以下值之一：

• BINARY[(N)]
• CHAR[(N)]
• DATE
• DATETIME
• DECIMAL
• SIGNED [INTEGER]
• TIME
• UNSIGNED [INTEGER]

遷移實戰建議

1. 建立對照表，批次替換所有 CONVERT() 呼叫。
2. 統一補齊列別名，避免 ORM 映射失敗。
3. 利用 CAST(expr AS type) 作為 ANSI SQL 標準替代方案，提升跨資料庫可移植性。
4. 針對日期/時間轉換，優先使用 DATE_FORMAT()、STR_TO_DATE() 等專用函數，效能與可讀性更佳。

掌握上述差異，即可大幅降低異構資料庫遷移時的語法修正成本，確保業務邏輯平滑落地。