title: CLIENT_ERRORS_SUMMARY_BY_USER summary: 了解 information_schema 表 CLIENT_ERRORS_SUMMARY_BY_USER。

CLIENT_ERRORS_SUMMARY_BY_USER

CLIENT_ERRORS_SUMMARY_BY_USER 表汇总了已返回给连接到 TiDB 服务器的客户端的 SQL 错误和警告。这些错误和警告包括：

  • 格式错误的 SQL 语句。
  • 除以零错误。
  • 尝试插入超出范围或重复的键值。
  • 权限错误。
  • 表不存在。

以上错误通过 MySQL 服务器协议返回给客户端，此时应用程序应在客户端采取适当操作。information_schema.CLIENT_ERRORS_SUMMARY_BY_USER 表提供了一种有效方法，能够在应用程序没有正确处理（或记录）TiDB 服务器返回的错误的情况下检查错误。

因为 CLIENT_ERRORS_SUMMARY_BY_USER 会基于每个用户汇总错误，所以在诊断一个用户服务器比其他服务器产生更多错误的方案时很有用。可能的情况包括：

  • 权限错误。
  • 表或关系对象丢失。
  • SQL 语法不正确，或应用程序和 TiDB 版本之间不兼容。

可以使用 FLUSH CLIENT_ERRORS_SUMMARY 语句重置汇总的计数。所汇总的是每个 TiDB 服务器的本地数据，并且只保留在内存中。如果 TiDB 服务器重新启动，会丢失汇总信息。

  1. USE information_schema;
  2. DESC CLIENT_ERRORS_SUMMARY_BY_USER;
  1. +---------------+---------------+------+------+---------+-------+
  2. | Field         | Type          | Null | Key  | Default | Extra |
  3. +---------------+---------------+------+------+---------+-------+
  4. | USER          | varchar(64)   | NO   |      | NULL    |       |
  5. | ERROR_NUMBER  | bigint(64)    | NO   |      | NULL    |       |
  6. | ERROR_MESSAGE | varchar(1024) | NO   |      | NULL    |       |
  7. | ERROR_COUNT   | bigint(64)    | NO   |      | NULL    |       |
  8. | WARNING_COUNT | bigint(64)    | NO   |      | NULL    |       |
  9. | FIRST_SEEN    | timestamp     | YES  |      | NULL    |       |
  10. | LAST_SEEN     | timestamp     | YES  |      | NULL    |       |
  11. +---------------+---------------+------+------+---------+-------+
  12. 7 rows in set (0.00 sec)

字段说明如下：

  • USER：已认证的用户。
  • ERROR_NUMBER：返回的与 MySQL 兼容的错误码。
  • ERROR_MESSAGE：与错误码匹配的错误消息（预处理语句形式）。
  • ERROR_COUNT：返回此错误给用户的次数。
  • WARNING_COUNT：返回此警告给用户的次数。
  • FIRST_SEEN：首次向用户发送此错误（或警告）的时间。
  • LAST_SEEN：最近一次向用户发送此错误（或警告）的时间。

以下示例显示了客户端连接到本地 TiDB 服务器时生成的警告。执行 FLUSH CLIENT_ERRORS_SUMMARY 语句后，会重置汇总。

  1. SELECT 0/0;
  2. SELECT * FROM CLIENT_ERRORS_SUMMARY_BY_USER;
  3. FLUSH CLIENT_ERRORS_SUMMARY;
  4. SELECT * FROM CLIENT_ERRORS_SUMMARY_BY_USER;
  1. +-----+
  2. | 0/0 |
  3. +-----+
  4. | NULL |
  5. +-----+
  6. 1 row in set, 1 warning (0.00 sec)
  8. +------+--------------+---------------+-------------+---------------+---------------------+---------------------+
  9. | USER | ERROR_NUMBER | ERROR_MESSAGE | ERROR_COUNT | WARNING_COUNT | FIRST_SEEN          | LAST_SEEN           |
  10. +------+--------------+---------------+-------------+---------------+---------------------+---------------------+
  11. | root |         1365 | Division by 0 |           0 |             1 | 2021-03-18 13:05:36 | 2021-03-18 13:05:36 |
  12. +------+--------------+---------------+-------------+---------------+---------------------+---------------------+
  13. 1 row in set (0.00 sec)
  15. Query OK, 0 rows affected (0.00 sec)
  17. Empty set (0.00 sec)