// MySQL エラーリファレンス
MySQL エラー 1071: 指定されたキーが長すぎます
インデックスが InnoDB の許容幅(3072 バイト、古い行形式では 767 バイト)を超えています。通常は、長い utf8mb4 の VARCHAR で発生します。
- エラー番号
1071- 名前
ER_TOO_LONG_KEY- SQLSTATE
42000- カテゴリ
- キーと制約
意味
最大キー長は、文字数ではなくバイト数で数えられます。次のケースでは utf8mb4 各文字は4バイトを使うことがあるため、 VARCHAR(255) 列あたり最大 1020 バイトが必要です。InnoDB で DYNAMIC または COMPRESSED 行フォーマットではインデックスあたり 3072 バイトまで許可されます。古い COMPACT そして REDUNDANT 形式では 767 が許可されています。そこが VARCHAR(255) 内 utf8mb4 失敗します。
よくある原因
- 長い列のユニークインデックス
utf8mb4VARCHAR、特に MySQL 5.6 や古い行フォーマットで。 - 列の合計が上限を超える複合インデックス。
修正方法
-
次を使用:
DYNAMIC行フォーマット(MySQL 5.7 以降の既定)。ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
列の接頭辞にインデックスを作成します。一意でないインデックスで有効です。
CREATE INDEX idx_users_bio ON users (bio(191));
-
長い値が不要な場合は、列を短くします。例:
VARCHAR(191)次の中のインデックス付きメール用utf8mb4767 バイトの制限未満。
関連エラー
その他のキーと制約のエラー
1062キーの重複エントリ1452外部キー制約違反: 子行を追加できません1451外部キー制約違反: 親行を削除できません1216子行を追加または更新することはできません1217親行を削除または更新することはできません1215外部キー制約を追加できません3780外部キーの列に互換性がありません1822外部キー制約にインデックスがない
コードとメッセージのテキストは、 MySQL 8.4 エラーメッセージ参照。全容は次で参照 MySQL エラー一覧 または すべてのデータベースエラーを検索.
// エラーが減り、修正も速く
SQLly で MySQL を操作する
macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、MySQL をはじめ、お使いの他のデータベースにも対応します。