この記事の要点
BLOB/TEXT column 'col' used in key specification without a key length はMySQL で TEXT/BLOB 列に INDEX を作ろうとしたエラー TEXT/BLOB は可変長なため、キー長を明示しないとインデックス不可 対処 ①: INDEX idx (col(255)) のようにプレフィックスインデックス 対処 ②: VARCHAR に型変更 (短い場合) 対処 ③: 全文インデックス FULLTEXT INDEX を使う

 

エラーの状況

-- ダメな例
CREATE TABLE articles (
    id BIGINT PRIMARY KEY,
    title TEXT,
    body TEXT,
    INDEX idx_title (title)  -- ← エラー
);
-- ERROR 1170 (42000): BLOB/TEXT column 'title' used in key specification
-- without a key length

MySQL では TEXT / BLOB 系の型は可変長で最大数 GB まで保存できるため、そのままインデックスを作るとサイズが大きすぎて非効率です。プレフィックス長を明示する必要があります。

対処方法

方法 1: プレフィックスインデックス（推奨）

-- 先頭 N バイトをインデックス化
CREATE TABLE articles (
    id BIGINT PRIMARY KEY,
    title TEXT,
    body TEXT,
    INDEX idx_title (title(255))  -- ← 先頭 255 文字
);

-- UNIQUE 制約
ALTER TABLE articles ADD UNIQUE INDEX uk_title (title(100));

-- 既存テーブルにインデックス追加
CREATE INDEX idx_title_prefix ON articles (title(255));

-- 検索は通常通り (プレフィックス内なら効く)
SELECT * FROM articles WHERE title = '特定タイトル';
SELECT * FROM articles WHERE title LIKE 'プレフィックス%';

方法 2: VARCHAR に変更（短い文字列なら）

-- TEXT → VARCHAR
ALTER TABLE articles MODIFY title VARCHAR(255);

-- これでインデックスは長さ指定不要
CREATE INDEX idx_title ON articles (title);

-- VARCHAR の上限
-- VARCHAR(65535) でも記述可だが行サイズ上限 65535 バイト
-- → 実用上は 1000 〜 5000 程度が推奨

方法 3: 全文インデックス (FULLTEXT)

長い文章を「単語単位」で検索したい場合:

CREATE TABLE articles (
    id BIGINT PRIMARY KEY,
    title TEXT,
    body LONGTEXT,
    FULLTEXT INDEX ft_body (body)
);

-- 検索
SELECT * FROM articles
WHERE MATCH(body) AGAINST('検索キーワード' IN NATURAL LANGUAGE MODE);

-- 複数列
ALTER TABLE articles ADD FULLTEXT INDEX ft_title_body (title, body);

-- 日本語の場合は ngram パーサ
ALTER TABLE articles
ADD FULLTEXT INDEX ft_body_ngram (body) WITH PARSER ngram;

プレフィックス長の決め方

長すぎるとサイズ無駄、短すぎると区別力低下:

-- カラムの一意性を確認
SELECT
    COUNT(DISTINCT LEFT(title, 10)) / COUNT(*) AS selectivity_10,
    COUNT(DISTINCT LEFT(title, 20)) / COUNT(*) AS selectivity_20,
    COUNT(DISTINCT LEFT(title, 50)) / COUNT(*) AS selectivity_50,
    COUNT(DISTINCT LEFT(title, 100)) / COUNT(*) AS selectivity_100,
    COUNT(DISTINCT title) / COUNT(*) AS full_selectivity
FROM articles;

-- 0.9 以上ならその長さで十分（90% 以上ユニーク）
-- 一般的に 50-255 で足りる

MySQL 文字列型の比較

型	最大サイズ	インデックス	用途
CHAR(N)	N 文字 (固定)	○ 通常	短い固定長
VARCHAR(N)	N 文字 (可変、最大 65535 バイト)	○ 通常 (N≤3072 バイト)	短〜中文字列
TINYTEXT	255 バイト	プレフィックス必須	小さい文字列
TEXT	65535 バイト (64KB)	プレフィックス必須	記事本文
MEDIUMTEXT	16MB	プレフィックス必須	長文
LONGTEXT	4GB	プレフィックス必須	ファイル相当
BLOB 系	同上	同上	バイナリ
JSON (MySQL 5.7+)	1GB	関数インデックス可能	構造化データ

UTF-8 でのインデックス長制限

-- utf8mb4 (絵文字対応) は 1 文字 4 バイト
-- InnoDB の DYNAMIC/COMPRESSED 行形式: インデックスキー上限 3072 バイト
-- → 文字数換算: 3072 / 4 = 768 文字

VARCHAR(768) → インデックス OK
VARCHAR(769) → エラー: Specified key was too long

-- 旧 utf8 (3 バイト) なら 1024 文字までOK

-- innodb_large_prefix が無効な場合 (古い InnoDB)
-- 上限 767 バイト (utf8mb4 で 191 文字)
SET GLOBAL innodb_large_prefix = 1;

JPA / Hibernate での @Column 指定

@Entity
public class Article {

    @Id @GeneratedValue
    private Long id;

    @Column(name = "title", length = 255)  // → VARCHAR(255)
    private String title;

    @Column(name = "body", columnDefinition = "TEXT")  // → TEXT
    private String body;

    @Lob  // → LONGTEXT / LONGBLOB
    private String content;
}

# Hibernate DDL 生成時、@Index を直接サポート
@Entity
@Table(name = "articles", indexes = {
    @Index(name = "idx_title", columnList = "title")
    // ※ VARCHAR ならプレフィックス指定不要
})
public class Article { }

関連エラー

エラー	意味
BLOB/TEXT column used in key specification without a key length	このページ
Specified key was too long; max key length is 3072 bytes	UTF-8 文字数 × バイト数が上限超過
Row size too large	1 行のサイズ上限超過 (65535 バイト)
Column count of mysql.user is wrong	MySQL アップグレード未完

関連記事

• Incorrect column specifier for column \'カラム名\'
• @Column
• MySQLの起動、停止、再起動