重要

現在表示されているページは、TiDBのアーカイブされたドキュメント (非更新) です。TiDBをご利用の場合、最新のLTS (Long Term Support) バージョンの使用を推奨します。

重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

エラーコードとトラブルシューティング

このドキュメントでは、TiDB の使用中に発生する問題について説明し、解決策を提供します。

エラーコード

TiDB は MySQL のエラーコードと互換性があり、ほとんどの場合、MySQL と同じエラーコードを返します。 MySQL のエラーコードのリストについては、 MySQL 5.7エラーメッセージリファレンスを参照してください。さらに、TiDB には次の固有のエラーコードがあります。

ノート：
一部のエラーコードは、内部エラーを表します。通常、TiDB はエラーをユーザーに返すのではなく処理するため、一部のエラーコードはここにリストされていません。
ここに記載されていないエラーコードが表示された場合は、サポートのためにお問い合わせ .

エラー番号: 8001
リクエストで使用されるメモリが、TiDB メモリ使用量のしきい値制限を超えています。
システム変数tidb_mem_quota_queryを構成して、単一の SQL ステートメントのメモリー制限を増やします。
エラー番号: 8002
一貫性を保証するために、コミットの競合が発生した場合、ステートメントがSELECT FOR UPDATEのトランザクションは再試行できません。 TiDB はトランザクションをロールバックし、このエラーを返します。
アプリケーションは、トランザクション全体を安全に再試行できます。
エラー番号: 8003
ADMIN CHECK TABLEコマンドの実行時に行のデータがインデックスと一致しない場合、TiDB はこのエラーを返します。このエラーは、テーブル内のデータ破損をチェックするときによく見られます。
あなたはサポートのためにお問い合わせできます。
エラー番号: 8004
1 つのトランザクションが大きすぎます。
原因と解決策については、エラーメッセージtransaction too largeますを参照してください。
エラー番号: 8005
完全なエラーメッセージ: ERROR 8005 (HY000): Write Conflict, txnStartTS is stale
TiDB のトランザクションで書き込み競合が発生します。このエラーを処理するには、 tidb_disable_txn_auto_retryがonに設定されているかどうかを確認します。その場合はoffに設定します。すでにoffになっている場合は、エラーが発生しなくなるまでtidb_retry_limitの値を増やします。
エラー番号: 8018
プラグインを再ロードするときに、プラグインが以前にロードされていない場合、このエラーが返されます。
プラグインの初期ロードを実行できます。
エラー番号: 8019
リロードされているプラグインのバージョンは、以前のバージョンとは異なります。したがって、プラグインを再ロードできず、このエラーが返されます。
プラグインのバージョンが以前のものと同じであることを確認することで、プラグインをリロードできます。
エラー番号: 8020
テーブルがロックされているときに、テーブルに対して書き込み操作を実行すると、このエラーが返されます。
テーブルのロックを解除し、書き込み操作を再試行してください。
エラー番号: 8021
TiKV から読み込むキーが存在しない場合、このエラーが返されます。このエラーは内部で使用され、外部結果は空の読み取りです。
エラー番号: 8022
トランザクションのコミットは失敗し、ロールバックされました。
アプリケーションは、トランザクション全体を安全に再試行できます。
エラー番号: 8023
トランザクションキャッシュの書き込み時に空の値を設定すると、このエラーが返されます。このエラーは内部で使用および処理され、アプリケーションには返されません。
エラー番号: 8024
無効な取引です。 TiDB が、実行中のトランザクションのトランザクション ID (開始タイムスタンプ) が取得されていないことを検出した場合、つまりこのトランザクションが無効であることを意味する場合、このエラーが返されます。
通常、このエラーは発生しません。このエラーが発生した場合は、サポートのためにお問い合わせを入力してください。
エラー番号: 8025
書き込まれている 1 つのキーと値のペアが大きすぎます。 TiDB でサポートされている単一の Key-Value ペアの最大サイズは、デフォルトで 6 MB です。
ペアがこの制限を超える場合は、 txn-entry-size-limitの構成値を適切に調整して制限を緩和する必要があります。
エラー番号: 8026
使用中のインターフェース関数は実装されていません。このエラーは内部でのみ使用され、アプリケーションには返されません。
エラー番号: 8027
テーブルスキーマのバージョンが古くなっています。 TiDB はスキーマの変更をオンラインで適用します。 TiDBサーバーのテーブルスキーマバージョンがシステム全体のテーブルスキーマバージョンよりも古い場合、SQL ステートメントを実行すると、このエラーが返されます。
このエラーが発生した場合は、TiDBサーバーと PD リーダー間のネットワークを確認してください。
エラー番号: 8028
TiDB はテーブルロックをサポートしていません。これは、MySQL ではメタデータロックと呼ばれ、他のデータベースではインテンションロックと呼ばれる場合があります。
トランザクションが実行されると、トランザクションはテーブルスキーマの変更を認識できません。したがって、トランザクションをコミットするとき、TiDB はトランザクションに関連するテーブルスキーマをチェックします。実行中に関連するテーブルスキーマが変更された場合、トランザクションのコミットは失敗し、このエラーが返されます。
アプリケーションは、トランザクション全体を安全に再試行できます。
エラー番号: 8029
このエラーは、データベース内の数値変換でエラーが発生した場合に発生します。このエラーは内部でのみ使用され、外部アプリケーションの特定のタイプのエラーに変換されます。
エラー番号: 8030
符号なし正整数を符号付き整数に変換すると、最大値を超えて負の整数として表示されます。このエラーは、主にアラートメッセージで発生します。
エラー番号: 8031
符号なし整数に変換される場合、負の整数は正の整数に変換されます。このエラーは、主にアラートメッセージで発生します。
エラー番号: 8032
無効なyear形式が使用されています。 yearは、1、2、または 4 桁のみを受け入れます。
エラー番号: 8033
無効なyearの値が使用されています。 yearの有効範囲は (1901, 2155) です。
エラー番号: 8037
無効なmode形式がweek関数で使用されています。 modeは [0, 7] 内の 1 桁でなければなりません。
エラー番号: 8038
フィールドがデフォルト値を取得できません。このエラーは通常、内部で使用され、外部アプリケーション用の特定の種類のエラーに変換されます。
エラー番号: 8040
サポートされていない操作が実行されます。たとえば、ビューまたはシーケンスに対してテーブルロック操作を実行します。
エラー番号: 8047
システム変数の値はサポートされていません。通常、このエラーは、データベースでサポートされていない変数値をユーザーが設定した場合に、アラーム情報で発生します。
エラー番号: 8048
サポートされていないデータベース分離レベルが設定されています。
サードパーティのツールまたはフレームワークを使用しているためにコードを変更できない場合は、 tidb_skip_isolation_level_checkを使用してこのチェックをバイパスすることを検討してください。
```
set @@tidb_skip_isolation_level_check = 1;
```
エラー番号: 8050
サポートされていない権限タイプが設定されています。
解決策については、 TiDB 操作に必要な権限を参照してください。
エラー番号: 8051
TiDB がクライアントから送信された Exec 引数リストを解析するときに、不明なデータ型が検出されます。
このエラーが発生した場合は、クライアントを確認してください。クライアントが正常な場合、お問い合わせはサポート用です。
エラー番号: 8052
クライアントからのデータパケットのシリアル番号が正しくありません。
このエラーが発生した場合は、クライアントを確認してください。クライアントが正常な場合、お問い合わせはサポート用です。
エラー番号: 8055
現在のスナップショットは古すぎます。データがガベージコレクションされている可能性があります。この問題を回避するには、値tidb_gc_life_timeを増やします。 TiDB は、実行時間の長いトランザクション用にデータを自動的に予約します。通常、このエラーは発生しません。
ガベージコレクションの概要とガベージコレクションの構成を参照してください。
エラー番号: 8059
自動ランダム ID が使い果たされ、割り当てられません。現在、このようなエラーから回復する方法はありません。自動ランダム機能を使用して割り当ての最大数を取得する場合は、bigint を使用することをお勧めします。また、自動ランダム列に値を手動で割り当てることは避けてください。
自動ランダムを参照してください。
エラー番号: 8060
自動増分オフセットが無効です。 auto_increment_incrementとauto_increment_offsetの値を確認します。
エラー番号: 8061
サポートされていない SQL ヒントです。
SQL ヒントを確認して変更するには、オプティマイザーのヒントを参照してください。
エラー番号: 8062
SQL ヒントで無効なトークンが使用されています。 SQL ヒントの予約語と競合します。
SQL ヒントを確認して変更するには、オプティマイザーのヒントを参照してください。
エラー番号: 8063
SQLヒントで設定したメモリ使用制限がシステムの上限を超えています。 SQL ヒントの設定は無視されます。
SQL ヒントを確認して変更するには、オプティマイザーのヒントを参照してください。
エラー番号: 8064
SQL ヒントの解析に失敗します。
SQL ヒントを確認して変更するには、オプティマイザーのヒントを参照してください。
エラー番号: 8065
SQL ヒントで無効な整数が使用されています。
SQL ヒントを確認して変更するには、オプティマイザーのヒントを参照してください。
エラー番号: 8066
JSON_OBJECTAGG関数の 2 番目のパラメーターが無効です。
エラー番号: 8101
プラグイン ID の形式が正しくありません。
正しい形式は[name]-[version]で、 nameとversionに-は使用できません。
エラー番号: 8102
プラグイン定義情報を読み込めません。
プラグインに関する設定を確認してください。
エラー番号: 8103
プラグイン名が間違っています。
プラグインの構成を確認してください。
エラー番号: 8104
プラグインのバージョンが一致しません。
プラグインの構成を確認してください。
エラー番号: 8105
プラグインは繰り返しロードされます。
エラー番号: 8106
プラグインは、名前がプラグイン名で始まらないシステム変数を定義します。
プラグインの開発者に連絡して変更してください。
エラー番号: 8107
読み込まれたプラグインでバージョンが指定されていないか、指定されたバージョンが低すぎます。
プラグインの構成を確認してください。
エラー番号: 8108
サポートされていない実行プランタイプです。このエラーは内部エラーです。
このエラーが発生した場合は、サポートのためにお問い合わせを入力してください。
エラー番号: 8109
索引の分析時に、指定された索引が見つかりません。
エラー番号: 8110
デカルト積演算は実行できません。
構成でcross-joinをtrueに設定します。
エラー番号: 8111
EXECUTEステートメントを実行すると、対応するPrepareステートメントが見つかりません。
エラー番号: 8112
EXECUTEステートメントのパラメーターの数がPrepareステートメントと一致していません。
エラー番号: 8113
EXECUTEステートメントで関連付けられたテーブルスキーマは、 Prepareステートメントの実行後に変更されました。
エラー番号: 8115
複数行のステートメントを準備することはサポートされていません。
エラー番号: 8116
DDL ステートメントの準備はサポートされていません。
エラー番号: 8120
トランザクションのstart tsoを取得できません。
PDサーバーの状態/監視/ログ、および TiDBサーバーと PDサーバー間のネットワークを確認します。
エラー番号: 8121
権限チェックが失敗します。
データベースの権限構成を確認してください。
エラー番号: 8122
指定されたワイルドカードに対応するテーブル名が見つかりません。
エラー番号: 8123
集計関数を含む SQL クエリは、集計されていない列を返します。これはonly_full_group_byモードに違反します。
SQL ステートメントを変更するか、 only_full_group_byモードを無効にしてください。
エラー番号: 8129
TiDB は、キーの長さが 65536 以上の JSON オブジェクトをまだサポートしていません。
エラー番号: 8130
完全なエラーメッセージ: ERROR 8130 (HY000): client has multi-statement capability disabled
このエラーは、以前のバージョンの TiDB からアップグレードした後に発生する可能性があります。 SQL インジェクション攻撃の影響を軽減するために、TiDB はデフォルトで複数のクエリが同じCOM_QUERYの呼び出しで実行されるのを防ぐようになりました。
システム変数tidb_multi_statement_modeを使用して、この動作を制御できます。
エラー番号: 8138
トランザクションが不正な行の値を書き込もうとしています。詳細については、データとインデックス間の不一致のトラブルシューティングを参照してください。
エラー番号: 8139
トランザクションは、ハンドルがインデックス内のハンドルと一致しない行を書き込もうとします。詳細については、データとインデックス間の不一致のトラブルシューティングを参照してください。
エラー番号: 8140
トランザクションは、データがインデックスデータと一致しない行を書き込もうとします。詳細については、データとインデックス間の不一致のトラブルシューティングを参照してください。
エラー番号: 8141
トランザクションがコミットされているとき、キーの存在アサーションは失敗します。詳細については、データとインデックス間の不一致のトラブルシューティングを参照してください。
エラー番号: 8143
非トランザクション DML ステートメントの実行中にバッチが失敗すると、ステートメントは停止します。詳細については、非トランザクション DML ステートメントを参照してください。
エラー番号: 8200
DDL 構文はまだサポートされていません。
MySQL DDL の互換性を参照してください。
エラー番号: 8214
DDL 操作はadmin cancel操作で終了します。
エラー番号: 8215
ADMIN REPAIR TABLEは失敗します。
このエラーが発生した場合は、サポートのためにお問い合わせを入力してください。
エラー番号: 8216
自動ランダム列の使用法が正しくありません。
変更するには自動ランダムを参照してください。
エラー番号: 8223
このエラーは、データがインデックスと一致していないことを検出した場合に発生します。
このエラーが発生した場合は、サポートのためにお問い合わせを入力してください。
エラー番号: 8224
DDL ジョブが見つかりません。
restoreの操作で指定したジョブIDが存在するか確認してください。
エラー番号: 8225
DDL 操作は完了しており、キャンセルできません。
エラー番号: 8226
DDL 操作はほぼ完了しており、キャンセルできません。
エラー番号: 8227
シーケンスの作成時に、サポートされていないオプションが使用されています。
サポートされているオプションのリストについては、シーケンスのドキュメントを参照してください。
エラー番号: 8228
Sequence でsetvalを使用すると、サポートされていない型が指定されます。
関数の例を見つけるには、シーケンスのドキュメントを参照してください。
エラー番号: 8229
トランザクションが生存時間を超えています。
現在のトランザクションをコミットまたはロールバックして、新しいトランザクションを開始します。
エラー番号: 8230
TiDB は現在、新しく追加された列のデフォルト値として Sequence を使用することをサポートしておらず、使用するとこのエラーを報告します。
エラー番号: 9001
完全なエラーメッセージ: ERROR 9001 (HY000): PD Server Timeout
PD 要求がタイムアウトしました。
PDサーバーの状態、監視データ、ログ、TiDBサーバーとPDサーバー間のネットワークを確認します。
エラー番号: 9002
完全なエラーメッセージ: ERROR 9002 (HY000): TiKV Server Timeout
TiKV リクエストがタイムアウトしました。
TiKV サーバーのステータス、監視データ、ログ、および TiDBサーバーと TiKVサーバー間のネットワークを確認しサーバー。
エラー番号: 9003
完全なエラーメッセージ: ERROR 9003 (HY000): TiKV Server is Busy
TiKVサーバーがビジーで、これは通常、ワークロードが高すぎる場合に発生します。
TiKVサーバーの状態、監視データ、ログを確認します。
エラー番号: 9004
完全なエラーメッセージ: ERROR 9004 (HY000): Resolve Lock Timeout
ロック解決タイムアウト。このエラーは、データベースに多数のトランザクション競合が存在する場合に発生します。
アプリケーションコードを調べて、データベースにロック競合が存在するかどうかを確認してください。
エラー番号: 9005
完全なエラーメッセージ: ERROR 9005 (HY000): Region is unavailable
アクセスされたリージョンまたは特定のRaftグループが使用できません。レプリカが不十分であるなどの理由が考えられます。このエラーは通常、TiKVサーバーがビジー状態であるか、TiKV ノードがダウンしている場合に発生します。
TiKVサーバーのステータス、監視データ、およびログを確認します。
エラー番号: 9006
完全なエラーメッセージ: ERROR 9006 (HY000): GC life time is shorter than transaction duration
GC Life Timeの間隔が短すぎます。ロングトランザクションで読み取ったはずのデータが削除されている可能性があります。次のコマンドを使用してtidb_gc_life_timeを調整できます。
```
SET GLOBAL tidb_gc_life_time = '30m';
```
ノート：
「30m」は、30 分前に生成されたデータのみをクリーンアップすることを意味し、余分なストレージスペースを消費する可能性があります。
エラー番号: 9500
1 つのトランザクションが大きすぎます。
解決策については、エラーメッセージtransaction too largeますを参照してください。
エラー番号: 9007
完全なエラーメッセージ: ERROR 9007 (HY000): Write Conflict
TiKV のトランザクションで書き込み競合が発生します。
tidb_disable_txn_auto_retryがonに設定されているかどうかを確認します。その場合はoffに設定します。すでにoffになっている場合は、エラーが発生しなくなるまでtidb_retry_limitの値を増やします。
エラー番号: 9008
同時に TiKV に送信されるリクエストが多すぎます。数が制限を超えています。
tidb_store_limitを増やすか0に設定して、リクエストのトラフィックの制限を解除します。
エラー番号: 9010
TiKV はこのラフトログを処理できません。
TiKVサーバーの状態/モニター/ログを確認します。
エラー番号: 9012
TiFlash リクエストがタイムアウトしました。
TiFlash サーバーの状態/モニター/ログ、および TiDBサーバーと TiFlashサーバー間のネットワークを確認しサーバー。
エラー番号: 9013
TiFlashサーバーがビジーであり、これは通常、ワークロードが高すぎる場合に発生します。
TiFlashサーバーの状態/モニター/ログを確認します。

MySQL ネイティブエラーメッセージ

エラー番号: 2013 (HY000)
完全なエラーメッセージ: ERROR 2013 (HY000): Lost connection to MySQL server during query
このエラーは次のように処理できます。
- ログにpanicがあるかどうかを確認します。
- dmesg -T | grep -i oomを使用して dmesg に OOM が存在するかどうかを確認します。
- 長時間アクセスがない場合も、このエラーが発生する可能性があります。通常、TCP タイムアウトが原因です。 TCP が長期間使用されていない場合、オペレーティングシステムは TCP を強制終了します。
エラー番号: 1105 (HY000)
完全なエラーメッセージ: ERROR 1105 (HY000): other error: unknown error Wire Error(InvalidEnumValue(4004))
このエラーは通常、TiDB のバージョンが TiKV のバージョンと一致しない場合に発生します。バージョンの不一致を回避するには、バージョンをアップグレードするときにすべてのコンポーネントをアップグレードします。
エラー番号: 1148 (42000)
完全なエラーメッセージ: ERROR 1148 (42000): the used command is not allowed with this TiDB version
LOAD DATA LOCALステートメントを実行しても、MySQL クライアントがこのステートメントの実行を許可しない場合 ( local_infileオプションの値が 0)、このエラーが発生します。
解決策は、MySQL クライアントを起動するときに--local-infile=1オプションを使用することです。たとえば、コマンドmysql --local-infile=1 -u root -h 127.0.0.1 -P 4000を実行します。デフォルト値のlocal-infileは、MySQL クライアントのバージョンによって異なります。したがって、特定の MySQL クライアントで構成する必要があります。
エラー番号: 9001 (HY000)
完全なエラーメッセージ: ERROR 9001 (HY000): PD server timeout start timestamp may fall behind safe point
このエラーは、TiDB が PD へのアクセスに失敗した場合に発生します。 TiDB バックグラウンドのワーカーは PD からセーフポイントを継続的にクエリし、100 秒以内にクエリに失敗するとこのエラーを報告します。通常、PD のディスクが低速でビジー状態であるか、TiDB と PD 間のネットワークに障害が発生したことが原因です。一般的なエラーの詳細については、エラー番号と故障診断を参照してください。
TiDB ログエラーメッセージ: EOF エラー
クライアントまたはプロキシが TiDB から切断されても、TiDB は切断をすぐには認識しません。代わりに、TiDB は、接続にデータを返し始めたときにのみ、切断に気付きます。この時点で、ログには EOF エラーが出力れます。

トラブルシューティング

トラブルシューティングとFAQのドキュメントを参照してください。

エラーコードとトラブルシューティング

エラーコード

MySQL ネイティブ エラー メッセージ

トラブルシューティング

MySQL ネイティブエラーメッセージ