MySQL擴展函數開發指南：UDF與內建函數兩大路徑完整對比

為MySQL新增函數的兩條技術路徑

MySQL提供兩種機制擴展SQL函數功能，各有優劣，選擇取決於部署環境、維護策略、效能需求。

路徑一：使用者定義函數 (UDF, User-Defined Functions)

運作機制

• 以C/C++編寫，編譯為共享物件檔（Linux .so、Windows .dll）
• 透過CREATE FUNCTION動態載入至運行中服務器
• DROP FUNCTION可動態卸載，無需重啟服務

優點

• ✅ 可套用於二進位發布版，無需重新編譯MySQL原始碼
• ✅ 升級MySQL版本時，UDF通常相容（除非UDF介面變更）
• ✅ 獨立部署、版本管理彈性

缺點

• ❌ 需額外管理共享庫檔案分發、路徑配置（plugin_dir）
• ❌ 安全風險：惡意UDF可執行任意程式碼（MySQL限制plugin_dir目錄權限緩解）

路徑二：內建函數 (Native/Built-in Functions)

運作機制

• 直接修改MySQL原始碼（sql/item_func.cc等）
• 隨mysqld編譯連結，永久內建於服務器二進位檔

優點

• ✅ 無外部依賴，部署簡單（單一mysqld二進位檔）
• ✅ 呼叫開銷極低（無動態載入、符號解析成本）
• ✅ 核心開發團隊維護，穩定性最高

缺點

• ❌ 必須重新編譯MySQL原始碼，無法套用於官方二進位發布版
• ❌ 每次MySQL版本升級需重複Patch、重新編譯、測試
• ❌ 開發門檻高，需熟悉MySQL內核架構

第三種選擇：預存函數

• 純SQL撰寫（CREATE FUNCTION ... RETURNS ... BEGIN ... END）
• 無需編譯、無C/C++門檻、版本升級無痛遷移
• 效能較UDF/內建函數低（解析器解析、執行器解釋執行）
• 適用於業務邏輯封裝、複雜計算重用、非極致效能敏感場景

UDF開發入門關鍵點

必要介面函數

// 初始化函數
my_bool xxx_init(UDF_INIT *initid, UDF_ARGS *args, char *message);

// 主運算函數
long long xxx(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error);

// 反初始化函數
void xxx_deinit(UDF_INIT *initid);

編譯與安裝

# Linux範例
gcc -shared -o udf_example.so udf_example.cc -I/usr/include/mysql -fPIC
cp udf_example.so /usr/lib/mysql/plugin/  # 或 plugin_dir 指定路徑

# MySQL內註冊
CREATE FUNCTION my_func RETURNS INTEGER SONAME 'udf_example.so';

安全限制

• 僅允許從plugin_dir載入UDF（防止任意路徑載入）
• 需INSERT權限於mysql.func表才能註冊
• UDF執行權限受CREATE ROUTINE、EXECUTE控制

參考範例

MySQL原始碼套件sql/udf_example.cc提供完整範例，展示字串處理、數值運算、錯誤處理等常見模式。

選擇決策矩陣