在C语言中连接MySQL数据库需要借助MySQL提供的官方客户端库,通常称为MySQL C API,通过这个API,开发者可以在C程序中执行SQL语句、处理查询结果以及管理数据库连接,以下是详细的实现步骤和代码示例,帮助开发者快速掌握这一过程。

环境准备
在开始编写代码之前,确保开发环境已正确配置,首先需要安装MySQL服务器和MySQL C API开发库,以Linux系统为例,可以通过以下命令安装:
sudo apt-get install libmysqlclient-dev
在Windows系统中,可以从MySQL官网下载Connector/C开发包,并配置包含目录和库路径到开发环境(如Visual Studio)。
包含必要的头文件
在C程序中,需要包含MySQL C API的头文件mysql.h,并链接MySQL客户端库,在Linux下编译时,需添加-lmysqlclient选项:
#include <mysql/mysql.h> #include <stdio.h> #include <stdlib.h>
初始化连接句柄
MySQL连接通过MYSQL结构体管理,首先需要初始化一个连接句柄:
MYSQL *conn;
conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "mysql_init() failedn");
exit(1);
} 建立数据库连接
使用mysql_real_connect()函数建立与MySQL服务器的连接,该函数需要多个参数,包括主机名、用户名、密码、数据库名等:

conn = mysql_real_connect(conn, "localhost", "username", "password", "database_name", 0, NULL, 0);
if (conn == NULL) {
fprintf(stderr, "mysql_real_connect() failed: %sn", mysql_error(conn));
mysql_close(conn);
exit(1);
} 参数说明:
localhost:MySQL服务器地址,本地连接通常为localhost或0.0.1。username:数据库用户名。password:用户密码。database_name:要连接的数据库名称。0:端口号,默认为3306。NULL:Unix域套接字路径,通常为NULL。0:客户端标志,默认为0。
执行SQL语句
通过mysql_query()函数执行SQL语句,创建一个表:
if (mysql_query(conn, "CREATE TABLE IF NOT EXISTS users (id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50), age INT)")) {
fprintf(stderr, "CREATE TABLE failed: %sn", mysql_error(conn));
mysql_close(conn);
exit(1);
} 插入数据的示例:
const char *insert_query = "INSERT INTO users (name, age) VALUES ('Alice', 25)";
if (mysql_query(conn, insert_query)) {
fprintf(stderr, "INSERT failed: %sn", mysql_error(conn));
} 处理查询结果
对于SELECT查询,需要使用mysql_store_result()或mysql_use_result()获取结果集,以下是一个查询示例:
if (mysql_query(conn, "SELECT name, age FROM users")) {
fprintf(stderr, "SELECT failed: %sn", mysql_error(conn));
exit(1);
}
MYSQL_RES *result = mysql_store_result(conn);
if (result == NULL) {
fprintf(stderr, "mysql_store_result() failedn");
exit(1);
}
MYSQL_ROW row;
while ((row = mysql_fetch_row(result))) {
printf("Name: %s, Age: %sn", row[0], row[1]);
}
mysql_free_result(result); 关闭连接
操作完成后,务必关闭连接并释放资源:

mysql_close(conn);
完整代码示例
以下是一个完整的示例程序,展示了连接MySQL、插入数据和查询结果的全过程:
#include <mysql/mysql.h>
#include <stdio.h>
#include <stdlib.h>
int main() {
MYSQL *conn;
MYSQL_RES *result;
MYSQL_ROW row;
conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "mysql_init() failedn");
return 1;
}
conn = mysql_real_connect(conn, "localhost", "root", "password", "test_db", 0, NULL, 0);
if (conn == NULL) {
fprintf(stderr, "mysql_real_connect() failed: %sn", mysql_error(conn));
mysql_close(conn);
return 1;
}
// 插入数据
if (mysql_query(conn, "INSERT INTO users (name, age) VALUES ('Bob', 30)")) {
fprintf(stderr, "INSERT failed: %sn", mysql_error(conn));
}
// 查询数据
if (mysql_query(conn, "SELECT name, age FROM users")) {
fprintf(stderr, "SELECT failed: %sn", mysql_error(conn));
return 1;
}
result = mysql_store_result(conn);
if (result == NULL) {
fprintf(stderr, "mysql_store_result() failedn");
return 1;
}
printf("Query Results:n");
while ((row = mysql_fetch_row(result))) {
printf("Name: %s, Age: %sn", row[0], row[1]);
}
mysql_free_result(result);
mysql_close(conn);
return 0;
} 错误处理与最佳实践
- 错误处理:每次调用MySQL API后,都应检查返回值并处理可能的错误。
- 资源释放:确保释放结果集(
mysql_free_result)和关闭连接(mysql_close),避免内存泄漏。 - 安全性:避免SQL注入,使用参数化查询或对输入数据进行严格验证。
相关问答FAQs
Q1: 如何处理MySQL连接超时问题?
A1: 可以通过设置mysql_options()调整连接超时参数。
unsigned int timeout = 30; mysql_options(conn, MYSQL_OPT_CONNECT_TIMEOUT, &timeout);
确保MySQL服务器配置中wait_timeout和interactive_timeout的值合理。
Q2: 如何在多线程环境中安全使用MySQL C API?
A2: MySQL C API不是线程安全的,每个线程应使用独立的MYSQL句柄,并在调用API前加锁(如果共享连接),推荐每个线程创建自己的连接,避免并发问题。
【版权声明】:本站所有内容均来自网络,若无意侵犯到您的权利,请及时与我们联系将尽快删除相关内容!
发表回复