13.7.5.40 SHOW WARNINGS 语句
SHOW WARNINGS [LIMIT [offset,] row_count]
SHOW COUNT(*) WARNINGS
SHOW WARNINGS
是一个诊断语句,显示有关在当前会话中执行语句所导致的情况(错误、警告和注释)的信息。DML语句(如INSERT
、UPDATE
和LOAD DATA
)以及DDL语句(如CREATE TABLE
和ALTER TABLE
)都会生成警告。
LIMIT
子句的语法与SELECT
语句的语法相同。参见第 13.2.9 节“ SELECT 语句”。
SHOW WARNINGS
也被使用 在 EXPLAIN
后面显示 由 EXPLAIN
生成的扩展信息。参见第 8.8.3 节 “扩展的 EXPLAIN 输出格式”。
SHOW WARNINGS
显示有关当前会话中执行最新非诊断语句所导致的条件的信息。如果最近的语句在解析过程中导致错误,则无论语句类型如何(诊断或非诊断),SHOW WARNINGS
都会显示结果条件。
SHOW COUNT(*)WARNINGS
诊断语句显示错误、警告和注释的总数。您还可以从warning_count系统变量中检索此数字:
SHOW COUNT(*) WARNINGS;
SELECT @@warning_count;
这些语句的不同之处在于,第一个是诊断语句,不会清除消息列表。第二个,因为它是SELECT
语句,所以被认为是不可知的,并且确实清除了消息列表。
相关的诊断语句SHOW ERRORS
仅显示错误情况(不包括警告和注释),SHOW COUNT(*)ERRORS
语句显示错误总数。见第13.7.5.17节“显示错误声明”。GET DIAGNOSTICS
可用于检查个别情况的信息。见第13.6.7.3节“获取诊断声明”。
下面是一个简单的示例,显示了INSERT
的数据转换警告。该示例假设禁用了严格SQL模式。启用严格模式后,警告将变成错误并终止INSERT
。
mysql> CREATE TABLE t1 (a TINYINT NOT NULL, b CHAR(4));
Query OK, 0 rows affected (0.05 sec)mysql> INSERT INTO t1 VALUES(10,'mysql'), (NULL,'test'), (300,'xyz');
Query OK, 3 rows affected, 3 warnings (0.00 sec)
Records: 3 Duplicates: 0 Warnings: 3mysql> SHOW WARNINGS\G
*************************** 1. row ***************************Level: WarningCode: 1265
Message: Data truncated for column 'b' at row 1
*************************** 2. row ***************************Level: WarningCode: 1048
Message: Column 'a' cannot be null
*************************** 3. row ***************************Level: WarningCode: 1264
Message: Out of range value for column 'a' at row 3
3 rows in set (0.00 sec)
max_error_count
系统变量控制服务器存储信息的错误、警告和注释消息的最大数量,从而控制显示警告的消息数量。要更改服务器可以存储的消息数,请更改max_error_count
的值。默认值为64。
max_error_count
仅控制存储的消息数量,而不控制计数的数量。warning_count
的值不受max_error_count
的限制,即使生成的消息数超过max_error_count
。以下示例演示了这一点。ALTER TABLE
语句产生三条警告消息(该示例禁用了严格的SQL模式,以防止在单个转换问题后发生错误)。只存储和显示一条消息,因为max_error_count
已设置为1,但所有三条消息都被计数(如warning_count
的值所示):
mysql> SHOW VARIABLES LIKE 'max_error_count';
+-----------------+-------+
| Variable_name | Value |
+-----------------+-------+
| max_error_count | 64 |
+-----------------+-------+
1 row in set (0.00 sec)mysql> SET max_error_count=1, sql_mode = '';
Query OK, 0 rows affected (0.00 sec)mysql> ALTER TABLE t1 MODIFY b CHAR;
Query OK, 3 rows affected, 3 warnings (0.00 sec)
Records: 3 Duplicates: 0 Warnings: 3mysql> SHOW WARNINGS;
+---------+------+----------------------------------------+
| Level | Code | Message |
+---------+------+----------------------------------------+
| Warning | 1263 | Data truncated for column 'b' at row 1 |
+---------+------+----------------------------------------+
1 row in set (0.00 sec)mysql> SELECT @@warning_count;
+-----------------+
| @@warning_count |
+-----------------+
| 3 |
+-----------------+
1 row in set (0.01 sec)
要禁用消息存储,请将max_error_count
设置为0。在这种情况下,warning_count
仍然指示发生了多少警告,但消息不会被存储,也无法显示。
sql_notes
系统变量控制note消息是否递增warning_count
以及服务器是否存储它们。默认情况下,sql_notes
为1,但如果设置为0,notes不会递增warning_count
,服务器也不会存储它们:
mysql> SET sql_notes = 1;
mysql> DROP TABLE IF EXISTS test.no_such_table;
Query OK, 0 rows affected, 1 warning (0.00 sec)
mysql> SHOW WARNINGS;
+-------+------+------------------------------------+
| Level | Code | Message |
+-------+------+------------------------------------+
| Note | 1051 | Unknown table 'test.no_such_table' |
+-------+------+------------------------------------+
1 row in set (0.00 sec)mysql> SET sql_notes = 0;
mysql> DROP TABLE IF EXISTS test.no_such_table;
Query OK, 0 rows affected (0.00 sec)
mysql> SHOW WARNINGS;
Empty set (0.00 sec)
MySQL服务器向每个客户端发送一个计数,指示该客户端执行的最新语句产生的错误、警告和注释的总数。从C API中,可以通过调用mysql_warning_count()
来获得该值。请参阅mysql_warning_count()
。
在mysql客户端中,您可以分别使用warnings
和nowarning
命令或其快捷方式\W
和\w
启用和禁用自动警告显示(请参阅第4.5.1.2节“mysql客户端命令”)。例如:
mysql> \W
Show warnings enabled.
mysql> SELECT 1/0;
+------+
| 1/0 |
+------+
| NULL |
+------+
1 row in set, 1 warning (0.03 sec)Warning (Code 1365): Division by 0
mysql> \w
Show warnings disabled.