ホスト別のクライアントエラー要約
表CLIENT_ERRORS_SUMMARY_BY_HOST 、TiDBサーバーに接続したクライアントに返されたSQLエラーと警告の概要を示しています。これには以下が含まれます。
- 不正な SQL ステートメント。
- ゼロ除算エラー。
- 範囲外または重複したキー値を挿入しようとしました。
- 権限エラー。
- 存在しないテーブル。
これらのエラーはMySQLサーバープロトコルを介してクライアントに返され、アプリケーションは適切なアクションを実行することが期待されます。表INFORMATION_SCHEMA.CLIENT_ERRORS_SUMMARY_BY_HOSTは、アプリケーションがTiDBサーバーから返されたエラーを適切に処理（またはログに記録）していないシナリオにおいて、エラーを検査するための便利な方法を提供します。
CLIENT_ERRORS_SUMMARY_BY_HOSTリモートホストごとにエラーを要約するため、あるアプリケーションサーバーが他のサーバーよりも多くのエラーを生成しているシナリオを診断するのに役立ちます。考えられるシナリオは次のとおりです。
- 時代遅れの MySQL クライアント ライブラリ。
- 古いアプリケーション (新しいデプロイメントを展開するときにこのサーバーが見逃された可能性があります)。
- ユーザー権限の「ホスト」部分の使用方法が間違っています。
- 信頼性の低いネットワーク接続により、タイムアウトや接続切断がさらに発生します。
集計されたカウントは、ステートメントFLUSH CLIENT_ERRORS_SUMMARYを使用してリセットできます。集計は各 TiDBサーバーにローカルであり、メモリ内にのみ保持されます。TiDBサーバーを再起動すると、集計は失われます。
USE INFORMATION_SCHEMA;
DESC CLIENT_ERRORS_SUMMARY_BY_HOST;
出力は次のようになります。
+---------------+---------------+------+------+---------+-------+
| Field | Type | Null | Key | Default | Extra |
+---------------+---------------+------+------+---------+-------+
| HOST | varchar(255) | NO | | NULL | |
| ERROR_NUMBER | bigint(64) | NO | | NULL | |
| ERROR_MESSAGE | varchar(1024) | NO | | NULL | |
| ERROR_COUNT | bigint(64) | NO | | NULL | |
| WARNING_COUNT | bigint(64) | NO | | NULL | |
| FIRST_SEEN | timestamp | YES | | NULL | |
| LAST_SEEN | timestamp | YES | | NULL | |
+---------------+---------------+------+------+---------+-------+
7 rows in set (0.00 sec)
フィールドの説明:
HOST: クライアントのリモート ホスト。ERROR_NUMBER: 返された MySQL 互換エラー番号。ERROR_MESSAGE: エラー番号に一致するエラー メッセージ (プリペアドステートメント形式)。ERROR_COUNT: このエラーがクライアント ホストに返された回数。WARNING_COUNT: この警告がクライアント ホストに返された回数。FIRST_SEEN: このエラー (または警告) がクライアント ホストから初めて確認されました。LAST_SEEN: このエラー (または警告) がクライアント ホストから最後に確認された時刻。
以下の例は、クライアントがローカルTiDBサーバーに接続する際に生成される警告を示しています。1 FLUSH CLIENT_ERRORS_SUMMARY実行するとサマリーはリセットされます。
SELECT 0/0;
SELECT * FROM CLIENT_ERRORS_SUMMARY_BY_HOST;
FLUSH CLIENT_ERRORS_SUMMARY;
SELECT * FROM CLIENT_ERRORS_SUMMARY_BY_HOST;
出力は次のようになります。
+-----+
| 0/0 |
+-----+
| NULL |
+-----+
1 row in set, 1 warning (0.00 sec)
+-----------+--------------+---------------+-------------+---------------+---------------------+---------------------+
| HOST | ERROR_NUMBER | ERROR_MESSAGE | ERROR_COUNT | WARNING_COUNT | FIRST_SEEN | LAST_SEEN |
+-----------+--------------+---------------+-------------+---------------+---------------------+---------------------+
| 127.0.0.1 | 1365 | Division by 0 | 0 | 1 | 2021-03-18 12:51:54 | 2021-03-18 12:51:54 |
+-----------+--------------+---------------+-------------+---------------+---------------------+---------------------+
1 row in set (0.00 sec)
Query OK, 0 rows affected (0.00 sec)
Empty set (0.00 sec)