前置準備
- MySQL 5.0+(支援 Stored Procedure)
- MySQL C API:
libmysqlclient、頭文件 mysql.h
- 編譯連結:
gcc -o app main.c -lmysqlclient (Linux) 或 VS 專案加入 libmysql.lib
資料庫端:建立測試表與預存程序
-- 1. 建表
CREATE TABLE student (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(20),
age TINYINT,
remark VARCHAR(50)
);
-- 2. 插入測試資料
INSERT INTO student (name, age) VALUES ('zhouys', 90);
-- 3. 建立預存程序:依 id 查詢學生,回傳 out 參數
DELIMITER //
CREATE PROCEDURE querystudent(
IN in_id INT,
OUT out_ret INT,
OUT out_name VARCHAR(20),
OUT out_age INT
)
label_a: BEGIN
DECLARE v_name VARCHAR(20);
DECLARE v_age TINYINT;
IF in_id <= 0 THEN
SET out_ret = -1; -- 參數錯誤
LEAVE label_a;
END IF;
SELECT name, age INTO v_name, v_age FROM student WHERE id = in_id;
IF ROW_COUNT() = 0 THEN
SET out_ret = -2; -- 找不到
LEAVE label_a;
END IF;
SET out_ret = 0;
SET out_name = v_name;
SET out_age = v_age;
END //
DELIMITER ;
C 語言呼叫步驟
1. 初始化 MYSQL 結構體
MYSQL mysql;
if (!mysql_init(&mysql)) {
fprintf(stderr, "mysql_init failed\n");
return 1;
}
2. 連線資料庫(啟用 CLIENT_MULTI_STATEMENTS 支援 CALL)
if (!mysql_real_connect(&mysql, "localhost", "root", "", "testdb", 0, NULL, CLIENT_MULTI_STATEMENTS)) {
fprintf(stderr, "Connect failed: %s\n", mysql_error(&mysql));
mysql_close(&mysql);
return 1;
}
3. 呼叫預存程序
char query[256];
snprintf(query, sizeof(query), "CALL querystudent(1, @ret, @out_name, @out_age)");
if (mysql_real_query(&mysql, query, strlen(query))) {
fprintf(stderr, "CALL failed: %s\n", mysql_error(&mysql));
mysql_close(&mysql);
return 1;
}
4. 讀取 OUT 參數(必須另查用戶變數)
if (mysql_real_query(&mysql, "SELECT @ret, @out_name, @out_age", 0)) {
fprintf(stderr, "SELECT out params failed: %s\n", mysql_error(&mysql));
} else {
MYSQL_RES *res = mysql_store_result(&mysql);
if (res) {
MYSQL_ROW row = mysql_fetch_row(res);
if (row) {
int ret = atoi(row[0]);
const char *name = row[1] ? row[1] : "NULL";
int age = atoi(row[2]);
printf("ret=%d, name=%s, age=%d\n", ret, name, age);
}
mysql_free_result(res);
}
}
5. 清理資源
mysql_close(&mysql);
完整可編譯範例 (main.c)
#include
#include
#include
#include
int main() {
MYSQL mysql;
if (!mysql_init(&mysql)) { fprintf(stderr, "init fail\n"); return 1; }
if (!mysql_real_connect(&mysql, "localhost", "root", "password", "testdb", 3306, NULL, CLIENT_MULTI_STATEMENTS)) {
fprintf(stderr, "connect fail: %s\n", mysql_error(&mysql));
mysql_close(&mysql); return 1;
}
// 呼叫 SP
if (mysql_real_query(&mysql, "CALL querystudent(1, @ret, @out_name, @out_age)", 0)) {
fprintf(stderr, "call fail: %s\n", mysql_error(&mysql));
mysql_close(&mysql); return 1;
}
// 讀取 OUT 參數
if (mysql_real_query(&mysql, "SELECT @ret, @out_name, @out_age", 0)) {
fprintf(stderr, "select out fail: %s\n", mysql_error(&mysql));
} else {
MYSQL_RES *res = mysql_store_result(&mysql);
if (res) {
MYSQL_ROW row = mysql_fetch_row(res);
if (row) {
printf("ret=%s, name=%s, age=%s\n", row[0], row[1]?row[1]:"NULL", row[2]);
}
mysql_free_result(res);
}
}
mysql_close(&mysql);
return 0;
}
關鍵注意事項
- CLIENT_MULTI_STATEMENTS:連線時必須啟用,否則
CALL 會報錯 Commands out of sync。
- OUT 參數讀取:MySQL C API 不直接回傳 OUT 參數,必須執行
SELECT @var 取得用戶變數值。
- 結果集處理:
CALL 若包含 SELECT 會產生結果集,需用 mysql_store_result() / mysql_next_result() 循環處理所有結果集,避免 Commands out of sync。
- 參數綁定(進階):若需高效能/防注入,可使用
MYSQL_STMT + mysql_stmt_bind_param 預處理呼叫,但 MySQL 對預存程序的預處理支援有限,通常仍採字串拼裝 CALL sp(?, ?, ?) 搭配用戶變數。
- 錯誤處理:每個 API 呼叫後檢查回傳值,錯誤時用
mysql_error(&mysql) 取得詳細訊息。
C++ 封裝建議 (RAII)
class MySQLConn {
MYSQL mysql;
bool connected = false;
public:
MySQLConn() { mysql_init(&mysql); }
~MySQLConn() { if (connected) mysql_close(&mysql); }
bool connect(const char* host, const char* user, const char* pass, const char* db, unsigned int port=3306) {
connected = mysql_real_connect(&mysql, host, user, pass, db, port, NULL, CLIENT_MULTI_STATEMENTS);
return connected;
}
// 執行無結果集 SQL
bool exec(const char* sql) {
return mysql_real_query(&mysql, sql, strlen(sql)) == 0;
}
// 取得單行單列
bool querySingle(const char* sql, char* buf, size_t buflen) {
if (mysql_real_query(&mysql, sql, strlen(sql))) return false;
MYSQL_RES* res = mysql_store_result(&mysql);
if (!res) return false;
MYSQL_ROW row = mysql_fetch_row(res);
bool ok = row && row[0];
if (ok) strncpy(buf, row[0], buflen-1);
mysql_free_result(res);
return ok;
}
// 取得 OUT 參數
bool getOutParams(const char* fmt, ...) {
char sql[512];
va_list ap; va_start(ap, fmt); vsnprintf(sql, sizeof(sql), fmt, ap); va_end(ap);
return querySingle(sql, ...); // 視需求擴充
}
};