◀ 13.

【MySQLエラー】BLOB/TEXT column 'description' used in key

▶
編集
この記事の要点
  • 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 バイト)短〜中文字列
TINYTEXT255 バイトプレフィックス必須小さい文字列
TEXT65535 バイト (64KB)プレフィックス必須記事本文
MEDIUMTEXT16MBプレフィックス必須長文
LONGTEXT4GBプレフィックス必須ファイル相当
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 bytesUTF-8 文字数 × バイト数が上限超過
Row size too large1 行のサイズ上限超過 (65535 バイト)
Column count of mysql.user is wrongMySQL アップグレード未完

関連記事

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. 1071 Specified key was too long; max key length is 767 bytes
  2. ERROR 1063 (42000): Incorrect column specifier for column '～'
  3. mysqld: Can't change dir to '...\MySQL\MySQL Server X.X\data\' (OS errno 2 - No such file or directory)
  4. Install/Remove of the Service Denied!
  5. Datetime 型が NULL に見える
  6. Warning: World-writable config file '/etc/mysql/my.cnf' is ignored
  7. ERROR 1698 (28000): Access denied for user 'root'@'localhost'
  8. Exception: Wrong MySQL configuration
  9. [Warning] TIMESTAMP with implicit DEFAULT value is deprecated.
  10. ERROR 1820 (HY000): You must reset your password using ALTER USER statement before executing this statement.
  11. ERROR 1819 (HY000): Your password does not satisfy the current policy requirements
  12. Incorrect column specifier for column 'カラム名'
  13. BLOB/TEXT column 'description' used in key specification without a key length
  14. ERROR: /bin/sh: mysql_config: コマンドが見つかりません
  15. Host '...' is blocked because of many connection errors; unblock with 'mysqladmin flush-hosts'
  16. CSVエクスポート時に「ERROR 1045 (28000): Access denied for user 'username'@'localhost'」エラーが表示される
  17. Cannot execute statement: impossible to write to binary log since BINLOG_FORMAT = STATEMENT
  18. 1
  19. 1
  20. 1)
  21. 1
  22. 1
  23. 1
  24. 1
  25. 1
  26. 1
  27. 1
  28. 1
  29. 1
  30. 1
  31. 1
  32. 1
  33. 1"'`--
  34. 1
  35. 1
  36. 1
  37. 1
  38. 1
  39. 1
  40. 1
  41. 1
  42. 1
  43. 1)
  44. 1
  45. 1
  46. 1
  47. 1
  48. 1
  49. 1
  50. 1
  51. 1
  52. 1
  53. 1"'`--
  54. 1
  55. 1
  56. SQLSTATE[22007]: Invalid datetime format: 1366 Incorrect string value: ~
2026-05-18 07:42:07 T 3255

人気ページ

最近更新/作成されたページ