使用C语言访问MySQL数据 —— 连接和错误处理

2011-05-09 wcdj





可以通过许多不同的编程语言来访问MySQL，例如，C，C++，Java，Perl，Python，Tcl，PHP等。本文主要总结使用C语言接口如何访问MySQL数据。

(一) 连接例程

(二) 错误处理

(一) 连接例程

用C语言连接MySQL数据库包含两个步骤：

(1) 初始化一个连接句柄结构。使用 mysql_init 来初始化连接句柄。

(2) 实际进行连接。使用 mysql_real_connect 来向一个连接提供参数。

其余步骤：

(3) 使用完连接之后，使用 mysql_close 关闭连接。

(4) mysql_options 用于设置选项。注意：仅能在 mysql_init 和 mysql_real_connect 之间调用。mysql_options 一次只能设置一个选项，所以每设置一个选项就得调用它一次。

具体过程如下：

登录mysql

$ mysql -u root -p

输入密码

创建一个本地用户wcdj

mysql> GRANT ALL ON *.* TO wcdj@localhost IDENTIFIED BY 'secretpassword'; （注意：最后的分号）

退出root用户

mysql> /q

Bye

登录新创建的用户wcdj

$ mysql -u wcdj --password=secretpassword

创建一个新的数据库newdatabase

mysql> CREATE DATABASE newdatabase;

退出wcdj用户

mysql> /q

编写 create_children.sql 文件，用于创建表和添加数据。

--

-- Create the table children

--

CREATE TABLE children (

childno int(11) NOT NULL auto_increment,

fname varchar(30),

age int(11),

PRIMARY KEY (childno)

);

--

-- Populate the table 'children'

--

INSERT INTO children(childno, fname, age) VALUES (1, 'wcdj', 21);

INSERT INTO children(childno, fname, age) VALUES (2, 'gerry', 22);

INSERT INTO children(childno, fname, age) VALUES (3, 'echo', 23);

登录mysql

$ mysql -u wcdj --password=secretpassword newdatabase （注意，后面的newdatabase用于指定使用的数据库）

在新的数据库newdatabase中创建表children并添加数据：

mysql> /. create_children.sql

查看新添加的数据：

SELECT * from children;

1 wcdj 21

2 gerry 22

3 echo 23

connect1.c

#include <stdlib.h>
#include <stdio.h>
#include "mysql.h"
int main()
{
	MYSQL *conn_ptr;
	conn_ptr = mysql_init(NULL);
	if(!conn_ptr)
	{
		fprintf(stderr, "mysql_init failed/n");
		return EXIT_FAILURE;
	}
	conn_ptr = mysql_real_connect(conn_ptr, "localhost", "wcdj", "123", "newdatabase", 0, NULL, 0);
	if(conn_ptr)
	{
		printf("Connection success/n");
	}
	else
	{
		printf("Connection failed/n");
	}
	mysql_close(conn_ptr);
	return EXIT_SUCCESS;
}

编译程序：

$ gcc -I/usr/include/mysql connect1.c -L/usr/lib/mysql -lmysqlclient -o connet1

测试：

$ ./connect1

Connection success

$



(二) 错误处理

(1) unsigned int mysql_errno(MYSQL *connection); （错误码）

(2) char *mysql_error(MYSQL *connection); （文本错误信息）

可以通过调用 mysql_errno 并传递连接结构来获得错误码，它通常都是非0值。如果未设定错误码，它将返回0。

注意：因为每次调用库都会更新错误码，所以你只能得到最后一个执行命令的错误码。但是，上面列出的两个错误检查例程是例外，它们不会导致错误码的更新。

也可以调用 mysql_error ，来提供有意义的文本信息而不是单调的错误码。这些信息被写入一些内部静态内存空间中，所以如果想保存错误文本，你需要把它复制到别的地方。

注意：当调用 mysql_real_connect 时会遇到一个问题，因为它在失败时返回NULL指针，并没有提供一个错误码。但如果你将连接句柄作为一个变量，那么即使 mysql_real_connect 失败，你仍然能够处理它。

connect2.c

使用非动态分配的连接结构，以及编写一些基本的错误处理代码。

#include <stdlib.h>
#include <stdio.h>
#include "mysql.h"
int main()
{
	MYSQL my_connection;
	mysql_init(&my_connection);
	
	if (mysql_real_connect(&my_connection, "localhost", "wcdj", "123", "newdatabase", 0, NULL, 0))
	{
		printf("Connection success/n");
		mysql_close(&my_connection);
	}
	else
	{
		fprintf(stderr, "Connection failed/n");
		if (mysql_errno(&my_connection))
		{
			fprintf(stderr, "Connection error %d: %s/n", mysql_errno(&my_connection),
			mysql_error(&my_connection));
		}
	}
	return EXIT_SUCCESS;
}

编译程序：

$ gcc -I/usr/include/mysql connect2.c -L/usr/lib/mysql -lmysqlclient -o connet2

假设当前没有创建 newdatabase 这个数据库，运行 connect2 将提示如下错误信息：

测试：

$ ./connect2

Connection failed

Connection error 1049: Unknown database 'newdatabase'

登录mysql

$ mysql -u wcdj --password=123

创建一个新的数据库newdatabase

mysql> CREATE DATABASE newdatabase;

退出wcdj用户

mysql> /q

再此测试 connect2：

Connection success

修改 connect2.c 中的密码 123 为一个错误的密码，再测试会提示如下错误信息：

Connection failed

Connection error 1045: Access denied for user 'wcdj'@'localhost' (usig password: YES)





参考：

Linux 程序设计（第4版）第8章 P.283