Linux程序设计学习笔记第八章 MySQL（部分）

灰太狼 2023-02-26 13:22 6阅读 0赞

用C语言连接MySQL包含两个步骤：  
1.初始化一个连接句柄结构。  
2.实际进行连接。

初始化连接句柄：  
![在这里插入图片描述][20200715200330136.png]  
通常传递NULL给此例程，它返回一个指向新分配的连接句柄结构的指针。如果传递一个已有的结构，它将被重新初始化。mysql\_init函数出错时返回NULL。

分配和初始化一个句柄后，需要调用mysql\_real\_connect向一个连接提供参数：

MYSQL *mysql_real_connect(MYSQL *connection,
        const char *server_host,
        const char *sql_user_name,
        const char *sql_password,
        const char *db_name,
        unsigned int port_number,
        const char *unix_socket_name,
        unsigned int flags);

参数connection必须指向被mysql\_init函数初始化过的结构。

参数server\_host既可以是主机名，也可以是IP地址，如果是连接到本地机器，可通过指定localhost或NULL（两者含义相同）来优化连接类型，优化后，将使用套接字（UNIX）或命名管道（Windows）而非TCP/IP连接到数据库。

如果数据库登录名参数sql\_user\_name为NULL，则假设登录名为当前Linux用户的登录ID；如果数据库密码参数sql\_password为NULL，那么只能访问服务器上无需密码就能访问的内容。

MySQL端口号port\_name和unix\_socket\_name参数应该分别为0和NULL，除非改变了MySQL的默认设置，它们将默认使用合适的值。参数unix\_socket\_name指定使用的套接字或命名管道。

flags参数改变使用协议的某些特性。

使用完连接后，通常在程序退出时，要调用：  
![在这里插入图片描述][20200715213024788.png]  
如果参数connection是由mysql\_init函数建立的，MySQL结构会被释放，指针将会失效并无法再次使用。保留一个不需要的连接是对资源的浪费，而重新打开连接会带来额外开销，要权衡何时使用mysql\_close函数。

MySQL错误处理函数使用一系列由连接句柄结构报告的返回码：  
![在这里插入图片描述][20200715201840532.png]  
![在这里插入图片描述][2020071520185422.png]  
可调用mysql\_errno并传递连接句柄结构来获得错误码，它通常是非0值，如没有设定错误码，则返回0，每次调用库函数（除了以上两个错误检查例程）都会更新错误码，因此只能得到最后一个执行命令的错误码。

错误码定义在头文件errmsg.h或mysqld\_error.h中，前者报告客户端错误，后者关注服务器端错误。

mysql\_error函数返回文本错误信息，这些信息被写入内部静态内存空间中，因此如果想保存错误文本，需要把它复制到别的地方。

执行sql语句的API：  
![在这里插入图片描述][20200715214815574.png]  
参数query是不带分号的有效sql语句文本串。成功时，函数返回0。对于包含二进制数据的查询，可使用mysql\_real\_query函数。

对于不返回任何数据的sql语句，如update、delete、insert，检查受sql影响的行数：  
![在这里插入图片描述][20200715215213478.png]  
此函数的返回类型在printf时，推荐使用%ul格式将其转换成无符号长整型。这个函数返回受之前没有返回值的sql语句影响的行数。MySQL返回的是一个被更新操作修改的行数，但其他许多数据库仅因为某行记录匹配where字句就把它视为已更新过。

在C应用程序中提取数据库数据分以下步骤：  
1.执行查询。  
2.提取数据。  
3.处理数据。  
4.必要的清理工作。

先用mysql\_query函数发送sql语句，之后可以使用mysql\_use\_result（一次返回一行数据）或mysql\_store\_result（一次返回所有结果）函数来提取数据，结果集比较小时，后者比较合适。

![在这里插入图片描述][2020071613384160.png]  
此函数将返回所有查询到的数据，它返回一个指向结果集结构的指针，如果执行失败，则返回NULL。

mysql\_store\_result成功调用后，需要调用mysql\_num\_rows来得到返回记录的数目，一般是一个正数，如果没有返回行，mysql\_num\_rows函数将返回0。

![在这里插入图片描述][20200716134122235.png]  
如果mysql\_store\_result调用成功，则mysql\_num\_rows函数始终返回成功。

如果查询结果是一个特别庞大的数据集，最好提取小一些、更易管理的信息块，这样可以更快地将控制权返回给应用程序，且不会占用大量网络资源。

现在，可以调用mysql\_fetch\_row处理MYSQL\_RES结果结构，从中提取一行，并把该行放到一个行结构中，当数据用完或发生错误时，返回NULL：  
![在这里插入图片描述][20200716134510321.png]  
也可用mysql\_data\_seek函数在结果集中进行跳转，从而设置被下一个mysql\_fetch\_row函数返回的行：  
![在这里插入图片描述][20200716135556478.png]  
参数offset的值是一个行号，它必须在0到结果集总行数-1的范围内，传递0会导致下一个mysql\_fetch\_row调用返回结果集中的第一行。

完成了对数据的所有操作后，必须使用mysql\_free\_result函数让MySQL库完成善后处理：  
![在这里插入图片描述][20200716144509387.png]  
必须总是调用此函数让MySQL库清理它分配的对象。

逐行提取数据：  
![在这里插入图片描述][20200716140030769.png]  
执行失败时返回NULL，如果成功，返回指向结果集对象的指针。用mysql\_use\_result函数返回的MYSQL\_RES结构来调用msyql\_fetch\_row时，每次都从服务器取回行数据。

为得到所有数据，必须再反复调用mysql\_fetch\_row直到取得了所有数据（即直到mysql\_fetch\_row函数返回NULL），如果没有取完所有数据，则下次执行返回数据的sql语句时可能会返回遭到破坏的信息。

mysql\_use\_result调用不能与mysql\_data\_seek、mysql\_row\_seek、mysql\_row\_tell一起使用，并且由于直到所有数据都被提取后才能实际生效，因此mysql\_num\_rows的使用也受到限制。每个行请求和结果的返回都要通过网络，可能网络连接在中途失败，留下不完整的数据。但mysql\_use\_result函数更好地平衡了网络负载，减少了可能非常大的数据集带来的存储开销。

MySQL返回两种类型数据：元数据和表中的列数据。

mysql\_field\_count函数返回结果集中字段（列）的个数：  
![在这里插入图片描述][20200716142024959.png]  
在旧版本的MySQL代码中，mysql\_num\_fields函数可以接受一个连接结构或结果结构。

[20200715200330136.png]: /images/20230209/879923b5935c48dea49766e98bee51a7.png
[20200715213024788.png]: /images/20230209/175c289e08594837b43efd93c100b2bd.png
[20200715201840532.png]: /images/20230209/e9444486277a4454b810765b69d46f0a.png
[2020071520185422.png]: /images/20230209/6cf5b556ccdd4cf4940c2fe6a791e240.png
[20200715214815574.png]: https://img-blog.csdnimg.cn/20200715214815574.png
[20200715215213478.png]: https://img-blog.csdnimg.cn/20200715215213478.png
[2020071613384160.png]: https://img-blog.csdnimg.cn/2020071613384160.png
[20200716134122235.png]: https://img-blog.csdnimg.cn/20200716134122235.png
[20200716134510321.png]: https://img-blog.csdnimg.cn/20200716134510321.png
[20200716135556478.png]: https://img-blog.csdnimg.cn/20200716135556478.png
[20200716144509387.png]: https://img-blog.csdnimg.cn/20200716144509387.png
[20200716140030769.png]: https://img-blog.csdnimg.cn/20200716140030769.png
[20200716142024959.png]: https://img-blog.csdnimg.cn/20200716142024959.png