指定されたキーは長すぎます; 最大キー長は767バイトです」というエラーの解決方法


このエラーが発生する一般的な原因は、UTF-8などのマルチバイト文字エンコーディングを使用している場合、キーの長さが制限を超えてしまうことです。マルチバイト文字は、1文字あたり複数のバイトを使用するため、キーの長さが予想以上に増える可能性があります。

  1. インデックスのキー長を短くする: インデックスはテーブルのパフォーマンスを向上させるために使用されますが、キーの長さが制限を超えるとエラーが発生します。キー長を短くするためには、テキスト型のフィールドを短くするか、必要な場合は別のエンコーディング方式を検討することができます。

例:

ALTER TABLE テーブル名 MODIFY カラム名 VARCHAR(255);
  1. インデックスの文字エンコーディングを変更する: キーの長さを短くするために、文字エンコーディングを変更することもできます。UTF-8の代わりにUTF-8MB4などのエンコーディング方式を使用することで、より多くの文字を表現できます。

例:

ALTER TABLE テーブル名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  1. インデックスを複数のカラムに分割する: キーの長さが767バイトを超える場合、キーを複数のカラムに分割することで解決することができます。

例:

ALTER TABLE テーブル名 ADD INDEX インデックス名 (カラム1(255), カラム2(255));