MySQLエラー #1071 - トラブルシューティングガイド

2024-04-02

MySQLエラー #1071 - 指定されたキーが長すぎます。最大キー長は 767 バイトです

原因

このエラーが発生する主な原因は、以下の2つです。

VARCHAR型のキーが長すぎる

VARCHAR型は可変長文字列型であり、最大255バイトまでの文字列を格納できます。しかし、キーとして使用するVARCHAR型の列は、最大767バイトまでしか許容されません。

複合キーの長さが合計で767バイトを超えている

複数の列を組み合わせた複合キーを使用する場合、各列の長さの合計が767バイトを超えてはいけません。

解決方法

このエラーを解決するには、以下の方法を試してください。

VARCHAR型のキーとして使用する列の長さを、767バイト以下になるように短縮します。

複合キーの一部を削除する

複合キーの一部を削除して、キーの長さの合計を767バイト以下にする。

キーの長さを拡張する

MySQL 5.7以降では、innodb_large_prefixという設定パラメータを使用して、キーの長さを最大3072バイトまで拡張できます。ただし、この設定を変更すると、パフォーマンスに影響が出る可能性があります。

その他の注意点

InnoDB以外のストレージエンジンでは、キーの長さの制限が異なる場合があります。
キーの長さを変更する場合は、既存のデータとの互換性を考慮する必要があります。

CREATE TABLE users (
  id INT NOT NULL AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) NOT NULL,
  PRIMARY KEY (id, name)
);

INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');

このコードは、name列とemail列を複合キーとして使用するusersテーブルを作成します。しかし、name列とemail列の長さの合計は255 + 255 = 510バイトを超えているため、エラーが発生します。

CREATE TABLE users (
  id INT NOT NULL AUTO_INCREMENT,
  name VARCHAR(100) NOT NULL,
  email VARCHAR(255) NOT NULL,
  PRIMARY KEY (id, name)
);

INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');

このコードは、name列の長さを100バイトに短縮することで、エラーを解決します。

CREATE TABLE users (
  id INT NOT NULL AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) NOT NULL,
  PRIMARY KEY (id)
);

INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');

このコードは、複合キーからname列を削除することで、エラーを解決します。

SET global innodb_large_prefix = 1;

CREATE TABLE users (
  id INT NOT NULL AUTO_INCREMENT,
  name VARCHAR(255) NOT NULL,
  email VARCHAR(255) NOT NULL,
  PRIMARY KEY (id, name)
);

INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');