ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes

1.版本

1)操作系统

cat /etc/issue
cat /etc/issue
CentOS release 6.6 (Final)
Kernel \r on an \m

cat /proc/version
cat /proc/version
Linux version 2.6.32-504.el6.x86_64 (mockbuild@c6b9.bsys.dev.centos.org) (gcc version 4.4.7 20120313 (Red Hat 4.4.7-11) (GCC) ) #1 SMP Wed Oct 15 04:27:16 UTC 2014

2)mysql数据库版本

mysql --version
mysql  Ver 14.14 Distrib 5.6.26, for linux-glibc2.5 (x86_64) using  EditLine wrapper

2.问题描述

2.1 发现问题

  今天在修改innodb表的某个列的长度时，报如下错误：

[html]  view plain  copy

1. alter table test2 modify column id varchar(500);  
2. ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes  

3.分析问题

3.1 问题原因分析

其实从上面的报错中我们已经能看是因为索引达到长度限制，所以报错。查看id列是否有索引：

[html]  view plain  copy

1. mysql> show index from test2\G;  
2. *************************** 1. row ***************************  
3.         Table: test2  
4.    Non_unique: 1  
5.      Key_name: id  
6.  Seq_in_index: 1  
7.   Column_name: id  
8.     Collation: A  
9.   Cardinality: 0  
10.      Sub_part: NULL  
11.        Packed: NULL  
12.          Null: YES  
13.    Index_type: BTREE  
14.       Comment:   
15. Index_comment:   
16. 1 row in set (0.00 sec)  

##删除id列的索引后， alter table test2 modify操作可以正常执行

3.2 关于mysql索引长度限制

1)单列索引长度限制

[html]  view plain  copy

1. From the manual at http://dev.mysql.com/doc/refman/5.6/en/create-table.html >>从5.6的官方文档中我们能找到如下双引号中解释  
2. "For CHAR, VARCHAR, BINARY, and VARBINARY columns, indexes can be created that use only the leading part of column values, using col_name(length) syntax to specify an index prefix length.  
3. ...  
4. Prefixes can be up to 1000 bytes long (767 bytes for InnoDB tables). Note that prefix limits are measured in bytes, whereas the prefix length in CREATE TABLE statements is interpreted as number of characters ...">>>对于myisam和innodb存储引擎，prefixes的长度限制分别为1000 bytes和767 bytes。注意prefix的单位是bytes，但是建表时我们指定的长度单位是字符。  
5.   
6. A utf8 character can use up to 3 bytes. Hence you cannot index columns or prefixes of columns longer than 333 (MyISAM) or 255 (InnoDB) utf8 characters.  >>以utf8字符集为例，一个字符占3个bytes。因此在utf8字符集下，对myisam和innodb存储引擎创建索引的单列长度不能超过333个字符和255个字符  

[html]  view plain  copy

1. create table test2(id varchar(256),primary key(id));  
2. ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes  

##对于innodb表，索引列长度大于255时，会报错。

  从上面可以看出，mysql 在创建单列索引的时候对列的长度是有限制的 myisam和innodb存储引擎下长度限制分别为1000 bytes和767 bytes。(注意bytes和character的区别)

2) 组合索引长度限制

  对于innodb存储引擎，多列索引的长度限制如下：

每个列的长度不能大于767 bytes；所有组成索引列的长度和不能大于3072 bytes

参考如下例子(下面默认使用的使用innodb存储引擎，smallint 占2个bytes，timestamp占4个bytes，utf8字符集。utf8字符集下，一个character占三个byte)

[html]  view plain  copy

1. mysql> create table test3(id varchar(255),key(id));  
2. Query OK, 0 rows affected (0.11 sec)  >>索引列长度小于767(255*3=765),表创建成功  
3.   
4. mysql> drop table test3;  
5. Query OK, 0 rows affected (0.03 sec)  
6.   
7. mysql> create table test3(id varchar(256),key(id));  >>索引列长度大于767(256*3=768),所以创建表失败  
8. ERROR 1071 (42000): Specified key was too long; max key length is 767 bytes  
9. mysql> create table test3 (id varchar(255),name varchar(255),name1 varchar(255),name2 varchar(255),name3 varchar(5),key (id,name,name1,name2,name3));  >>innodb下多列索引，所有列长度和大于3072/3=1024 (255*4+5=1025),所以表创建失败  
10. ERROR 1071 (42000): Specified key was too long; max key length is 3072 bytes  
11. mysql> create table test3 (id varchar(255),name varchar(255),name1 varchar(255),name2 varchar(255),name3 varchar(4),key (id,name,name1,name2,name3));  >>  
12. Query OK, 0 rows affected (0.09 sec)  

  对于myisam存储引擎，多列索引长度限制如下：

每个列的长度不能大于1000 bytes，所有组成索引列的长度和不能大于1000 bytes

例子如下

[html]  view plain  copy

1. mysql> create table test3(id varchar(334),key(id)) engine=myisam; >>索引列长度大于1000 bytes (334*3=1002)，建表报错  
2. ERROR 1071 (42000): Specified key was too long; max key length is 1000 bytes  
3. mysql> create table test3(id varchar(333),key(id)) engine=myisam;  >>索引列长度小于1000 bytes (333*3=999),建表成功  
4. Query OK, 0 rows affected (0.07 sec)  
5.   
6. mysql> create table test3(id varchar(300),name varchar(34),key(id,name)) engine=myisam; >>多列索引，所有列长度大于1000 bytes 建表报错  
7. ERROR 1071 (42000): Specified key was too long; max key length is 1000 bytes  
8. mysql>   

4. 问题解决方案

1) using col_name(length) syntax to specify an index prefix length.

对列的前面某部分创建索引

2) 启用innodb_large_prefix参数

[html]  view plain  copy

1. innodb_large_prefix >>启用innodb_large_prefix参数能够取消对于索引中每列长度的限制(但是无法取消对于索引总长度的限制)  
2. 启用innodb_large_prefix有如下前提条件：  
3. Enable this option to allow index key prefixes longer than 767 bytes (up to 3072 bytes) for InnoDB tables that use the DYNAMIC and COMPRESSED row formats.(Creating such tables also requires the option values innodb_file_format=barracuda and innodb_file_per_table=true.) >>启用innodb_large_prefix必须同时指定innodb_file_format=barracuda，innodb_file_per_table=true，并且建表的时候指定表的row_format为dynamic或者compressed(mysql 5.6中row_format默认值为compact)  
4. See Section 14.6.7, “Limits on InnoDB Tables” for the relevant maximums associated with index key prefixes under various settings. >>  
5. For tables using the REDUNDANT and COMPACT row formats, this option does not affect the allowed key prefix length.  

例子如下：

[html]  view plain  copy

1. 1. 查看innodb_large_prefix，innodb_file_format参数  
2. mysql> show variables like 'innodb_large_prefix';  
3. +---------------------+-------+  
4. | Variable_name       | Value |  
5. +---------------------+-------+  
6. | innodb_large_prefix | OFF   |  
7. +---------------------+-------+  
8. 1 row in set (0.01 sec)  
9.   
10. mysql> show variables like 'innodb_file_format';  
11. +--------------------+----------+  
12. | Variable_name      | Value    |  
13. +--------------------+----------+  
14. | innodb_file_format | Antelope |  
15. +--------------------+----------+  
16. 1 row in set (0.00 sec)  
17.   
18. 2. 建索引测试(innodb_large_prefix,innodb_file_format都为默认值的情况下)  
19. mysql> create table test3(id varchar(256),key (id));    
20. ERROR 1709 (HY000): Index column size too large. The maximum column size is 767 bytes.  
21.   
22. mysql> create table test3(id varchar(255),name varchar(255),name1 varchar(255),name2 varchar(255),name3 varchar(5),key (id,name,name1,name2,name3));  
23. ERROR 1071 (42000): Specified key was too long; max key length is 3072 bytes  
24. ##索引列大于767 bytes时报错，组合索引列的总长度大于3072 bytes时报错  
25.   
26. 3. 修改innodb_large_prefix,innodb_file_format参数  
27. mysql> set global innodb_large_prefix=1;  
28. Query OK, 0 rows affected (0.00 sec)  
29. mysql> set global innodb_file_format=BARRACUDA;  
30. Query OK, 0 rows affected (0.00 sec)  
31.   
32. 4. 对row_format为dynamic格式表创建索引测试  
33. mysql> create table test3(id varchar(256),key (id)) row_format=dynamic;  
34. Query OK, 0 rows affected (0.14 sec)    
35.   
36. mysql> create table test3(id varchar(255),name varchar(255),name1 varchar(255),name2 varchar(255),name3 varchar(5),key (id,name,name1,name2,name3)) row_format=dynamic;   
37. ERROR 1071 (42000): Specified key was too long; max key length is 3072 bytes  
38. ##innodb_large_prefix=1并且innodb_file_format=BARRACUDA时，对于row_format为dynamic的表可以指定索引列长度大于767 bytes。但是索引列总长度的不能大于3072 bytes的限制仍然存在  

参考阅读：

关于mysql innodb 如何保存大对象(BLOB等)，最强解析

Blob Storage in Innodb