// MySQL エラーリファレンス

MySQL エラー 1071: 指定されたキーが長すぎます

インデックスが InnoDB の許容幅(3072 バイト、古い行形式では 767 バイト)を超えています。通常は、長い utf8mb4 の VARCHAR で発生します。

エラー番号
1071
名前
ER_TOO_LONG_KEY
SQLSTATE
42000
カテゴリ
キーと制約
エラーメッセージ
Specified key was too long; max key length is %d bytes

意味

最大キー長は、文字数ではなくバイト数で数えられます。次のケースでは utf8mb4 各文字は4バイトを使うことがあるため、 VARCHAR(255) 列あたり最大 1020 バイトが必要です。InnoDB で DYNAMIC または COMPRESSED 行フォーマットではインデックスあたり 3072 バイトまで許可されます。古い COMPACT そして REDUNDANT 形式では 767 が許可されています。そこが VARCHAR(255) 内 utf8mb4 失敗します。

よくある原因

  • 長い列のユニークインデックス utf8mb4 VARCHAR、特に MySQL 5.6 や古い行フォーマットで。
  • 列の合計が上限を超える複合インデックス。

修正方法

  1. 次を使用: DYNAMIC 行フォーマット(MySQL 5.7 以降の既定)。

    ALTER TABLE users ROW_FORMAT = DYNAMIC;
  2. 列の接頭辞にインデックスを作成します。一意でないインデックスで有効です。

    CREATE INDEX idx_users_bio ON users (bio(191));
  3. 長い値が不要な場合は、列を短くします。例: VARCHAR(191) 次の中のインデックス付きメール用 utf8mb4 767 バイトの制限未満。

関連エラー

その他のキーと制約のエラー

コードとメッセージのテキストは、 MySQL 8.4 エラーメッセージ参照。全容は次で参照 MySQL エラー一覧 または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で MySQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、MySQL をはじめ、お使いの他のデータベースにも対応します。