MySQL :: MySQL 9.0 参考手册 :: B.2 错误信息接口

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

B.2 错误信息接口

错误信息可能源自服务器端或客户端，并且每个错误信息都包含错误代码、SQLSTATE 值和消息字符串，如第 B.1 节 “错误信息来源和元素” 中所述。有关服务器端、客户端和全局（服务器和客户端之间共享）错误的列表，请参阅 MySQL 9.0 错误信息参考。

要从程序内部进行错误检查，请使用错误代码编号或符号，而不是错误消息字符串。消息字符串不经常更改，但也有可能更改。此外，如果数据库管理员更改了语言设置，则会影响消息字符串的语言；请参阅第 12.12 节 “设置错误信息语言”。

MySQL 中的错误信息在服务器错误日志、SQL 级别、客户端程序内部以及命令行中可用。

在服务器端，某些消息旨在用于错误日志。有关配置服务器写入日志的位置和方式的信息，请参阅第 7.4.2 节 “错误日志”。

其他服务器错误消息旨在发送到客户端程序，并且如客户端错误信息接口中所述。

特定错误代码所在的范围决定了服务器是将错误消息写入错误日志还是将其发送到客户端。有关这些范围的信息，请参阅错误代码范围。

在 SQL 级别，MySQL 中有几个错误信息来源

SQL 语句警告和错误信息可通过 SHOW WARNINGS 和 SHOW ERRORS 语句获得。 warning_count 系统变量指示错误、警告和注释的数量（如果禁用了 sql_notes 系统变量，则排除注释）。 error_count 系统变量指示错误的数量。其值不包括警告和注释。
GET DIAGNOSTICS 语句可用于检查诊断区域中的诊断信息。请参阅第 15.6.7.3 节 “GET DIAGNOSTICS 语句”。
SHOW REPLICA STATUS 语句输出包含有关副本服务器上发生的复制错误的信息。
SHOW ENGINE INNODB STATUS 语句输出包含有关最近一次外键错误的信息（如果 CREATE TABLE 语句创建 InnoDB 表失败）。

客户端程序从两个来源接收错误

特定错误代码所在的范围决定了它是源自客户端库内部还是由客户端从服务器接收的。有关这些范围的信息，请参阅错误代码范围。

无论错误是源自客户端库内部还是从服务器接收的，MySQL 客户端程序都通过调用客户端库中的 C API 函数来获取错误代码、SQLSTATE 值、消息字符串和其他相关信息

mysql_errno() 返回 MySQL 错误代码。
mysql_sqlstate() 返回 SQLSTATE 值。
mysql_error() 返回消息字符串。
mysql_stmt_errno()、mysql_stmt_sqlstate() 和 mysql_stmt_error() 是预处理语句的相应错误函数。
mysql_warning_count() 返回最近一次语句的错误、警告和注释的数量。

有关客户端库错误函数的说明，请参阅 MySQL 9.0 C API 开发者指南。

MySQL 客户端程序可以多种方式响应错误。客户端可以显示错误消息，以便用户可以采取纠正措施，在内部尝试解决或重试失败的操作，或采取其他操作。例如，（使用 mysql 客户端），无法连接到服务器可能会导致出现以下消息

$> mysql -h no-such-host
ERROR 2005 (HY000): Unknown MySQL server host 'no-such-host' (-2)

perror 程序从命令行提供有关错误代码的信息。请参阅第 6.8.1 节 “perror — 显示 MySQL 错误信息”。

$> perror 1231
MySQL error code MY-001231 (ER_WRONG_VALUE_FOR_VAR): Variable '%-.64s'
can't be set to the value of '%-.200s'

$> ndb_perror 323
NDB error code 323: Invalid nodegroup id, nodegroup already existing:
Permanent error: Application error