Windows 下 MySQL UDF 開發全流程：從 VC++ 編譯到 CREATE FUNCTION 部署

UDF 簡介

User-Defined Function (UDF) 允許以 C/C++ 編寫自定義標量/聚合函數，編譯為動態鏈接庫 (.dll)，通過 CREATE FUNCTION ... SONAME 'xxx.dll' 註冊到 MySQL，SQL 中直接調用，性能接近內建函數。

開發環境

• Windows (文中 Win2000/NT，現代同理)
• Visual C++ 6.0 / VS 2019+ (需 C++ 桌面開發工作負載)
• MySQL 源碼包 (含 include/mysql.h、lib/libmysql.lib)
• 運行中的 MySQL 服務 (測試用)

步驟 1：創建 DLL 項目

1. 打開 mysqld.dsw (或新建 Solution)
2. Add New Project → **Win32 Dynamic-Link Library** → 名稱 my_udf
3. 選擇 **An Empty DLL Project** → Finish

步驟 2：編寫 UDF 源碼 my_udf.cpp

#include 
#include       // Windows Socket 頭文件 (MySQL 依賴)
#include         // MySQL UDF API 定義

// C 鏈接規約，防止名稱修飾
extern "C" {
    char *my_name(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error);
}

// 實現：返回固定字符串
char *my_name(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error) {
    char *me = "my name";   // 靜態/堆內存均可，生命周期由調用方管理
    return me;
}

步驟 3：定義導出表 my_udf.def

LIBRARY         UDF_EXAMPLE
DESCRIPTION     'Example Using UDF with VC++'
VERSION         1.0
EXPORTS
    my_name

關鍵：EXPORTS 列出的函數名必須與 C++ 實現完全一致，大小寫敏感。

步驟 4：項目屬性配置

1. 右鍵項目 → **Properties**
2. C/C++ → General → Additional Include Directories：添加 MySQL 源碼 include 目錄 (如 ..\include)
3. C/C++ → Preprocessor → Preprocessor Definitions：添加 HAVE_DLOPEN
4. Linker → General → Additional Library Directories：添加 MySQL lib 目錄
5. Linker → Input → Additional Dependencies：添加 libmysql.lib
6. Build → **F7** 生成 my_udf.dll (Release 版本)

步驟 5：部署 DLL

複製 my_udf.dll 到系統 PATH 目錄：

• C:\Windows\System32 (系統級，需管理員)
• 或 MySQL 安裝目錄 bin (推薦，隨實例遷移)
• 或自定義目錄並添加到系統/用戶 PATH

步驟 6：MySQL 註冊與測試

mysql -u root -p
CREATE FUNCTION my_name RETURNS STRING SONAME 'my_udf.dll';
SELECT my_name();  -- 輸出: my name
DROP FUNCTION my_name;

進階 UDF 類型與 API

標量函數完整簽名

my_bool xxx_init(UDF_INIT *initid, UDF_ARGS *args, char *message);
void xxx_deinit(UDF_INIT *initid);
char *xxx(UDF_INIT *initid, UDF_ARGS *args, char *result, unsigned long *length, char *is_null, char *error);

常見坑點與解決

安全與生產建議

1. 簽名驗證：僅載入受信簽名 DLL，防惡意 UDF 注入
2. 權限隔離：CREATE FUNCTION 需 INSERT 權限於 mysql.func 表，嚴格控制
3. 版本兼容：MySQL 升級後 UDF 可能需重新編譯 (ABI 變更)
4. 監控審計：記錄 CREATE/DROP FUNCTION、UDF 調用耗時/錯誤
5. 優先考慮內建/存儲函數：UDF 引入 C++ 運行時風險，非性能瓶頸勿用

結語

Windows 下 UDF 開發核心在於：**VC++ 項目配置正確 (Include/Lib/Def/Calling Convention) + DLL 放入有效 PATH + MySQL 註冊語法精確**。掌握此流程，即可將高性能 C++ 算法無縫嵌入 SQL，但請謹記「能用 SQL/存儲過程解決的，盡量不用 UDF」。