《MySQL排错指南》——1.4　获取查询信息-CSDN博客

本节书摘来自异步社区出版社《MySQL排错指南》一书中的第1章，第1.4节，作者：【美】Sveta Smirnova（斯维特斯米尔诺娃），更多章节内容可以访问云栖社区“异步社区”公众号查看。

1.4　获取查询信息

正如前一节看到的一样，数据库会返回一些关于每个查询的重要信息，有些信息直接展现在MySQL的访问客户端中，而有些信息则需要通过如SHOW WARNINGS等命令才能得到。当从应用程序中调用SQL语句的时候，获取这些返回信息并确认没有异常情况发生同样重要。所有语言的MySQL API都提供了获取服务器返回信息的接口。本节将讨论这些接口。这里仅涉及C的API，因为我必须选择一种语言的API，并且大部分其他语言的API都是基于C的API的[2]。

受影响的行数
我们从之前见过的输出开始，每次插入、更新或者删除后都会显示有多少行数据插入、更新或者删除了：

这个信息代表查询正常执行并且修改了N行数据。

要在应用程序中获取相同的信息，可以调用：

如果有改变发生，该函数会返回一个正数，如果没有改变那么返回0，−1代表反生错误。

对于UPDATE语句，如果客户端设置了CLIENT_FOUND_ROWS，那么该函数将会返回满足WHERE条件的行数，这个数并不总是和实际更改的行数一致。

提示　提示

对于Connector/J来说，默认不启用受影响的行，因为这不是JDBC兼容的特性并且会使其DML语句依赖于匹配的行数而不是受影响的行数的大多数应用程序产生错误。不过对于INSERT...ON DUPLICATE KEY UPDATE类型的语句会返回正确的更新数量。连接字符串属性useAffectedRows告诉Connector/J在连接到服务器的时候是否设置CLIENT_FOUND_ROWS标志。
匹配的行数
输出中表示该数目的字符串是：

该输出表明有多少行满足WHERE条件。

下面的C函数：

以字符串格式返回关于最近的查询的补充信息。

对于更新操作来说，它返回的字符串类似：

其中，每个#依次对应代表匹配的行数、修改的行数和警告数目。可以通过解析该行中的“matched: #”获悉有多少行被查找出来。

被修改的行数
输出中代表该数目的字符串是：

该输出表明有多少行实际上修改了。需要注意的是，匹配行数M和修改的行数P是可以不同的。例如，假设你想要修改的列已经包含你指定的值，在这种情况下，该列会被认为是匹配的而不是修改的。

在应用程序中，像之前一样用mysql_info()获取信息，不过这次是解析“Changed: #”。

警告：数目和消息
输出中表示这部分信息的字符串是：

如果服务器在处理请求过程中探查到一些不寻常的情况或者值得报告的情况，你将会获得警告。不过查询仍然会执行并且会修改数据。无论如何请确保检查警告信息，因为它们会帮助你获悉潜在的问题。

在应用程序中，有很多不同的方式去获取警告。仍可以使用mysql_info()函数，然后解析“Warinings: #”。也可以调用：

如果有警告，可以执行SHOW WARNINGS命令去获取关于究竟发生了什么的文本消息。另一个选择是：

该函数将返回最近的SQL状态（SQLSTATE）。例如，“42000”代表语法错误，“00000”代表没有错误和警告。

提示　提示

SQLSTATE的值由ANSI SQL标准定义，用于表明语句的执行状态。执行状态被设置成标准中定义的状态码，表明一个请求是成功完成还是返回异常。SQLSTATE以字符串形式返回。要了解MySQL服务器可能返回哪些状态码，可以阅读MySQL参数手册中的“服务器错误码和错误消息”一节。
错误
检查错误也总是很有用。下面的函数返回最近SQL语句的错误值。

　　..tu18-1.tif

该函数返回最近一次错误的MySQL错误代码。例如，语法错误会生成数字1064，0意味着没有错误。