萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C/C++ 呼叫 MySQL 預存程序完整實戰指南

前置準備

  • 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, ...); // 視需求擴充
  }
};
copyright © 萬盛學電腦網 all rights reserved