mysql - 错误：指定的密钥太长；最大密钥长度为 1000 字节

Question

错误：

1071 - 指定的密钥太长；最大密钥长度为 1000 字节

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id` , `module_id` )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

我知道发生错误是因为 255x2x3（每个字符 3 个字节）

并非所有安装都会发生这种情况。我可以更改什么设置？

score 15 · Accepted Answer

NO_ENGINE_SUBSTITUTION 禁用且 INNODB 未激活，这是一个错误的组合

在 MySql 5.5 之前，sqlmode 默认为空字符串，这意味着默认情况下未设置 sqlmode NO_ENGINE_SUBSTITUTION

根据 MySql 文档（参见https://dev.mysql.com/doc/refman/5.6/en/sql-mode.html#sqlmode_no_engine_substitution），这是 sqlmode NO_ENGINE_SUBSTITUTION 的含义：

当 CREATE TABLE 或 ALTER TABLE 等语句指定禁用或未编译的存储引擎时，控制默认存储引擎的自动替换。

因为存储引擎可以在运行时插入，所以不可用的引擎以相同的方式处理：

禁用 NO_ENGINE_SUBSTITUTION 后，对于 CREATE TABLE，使用默认引擎，如果所需引擎不可用，则会出现警告。对于 ALTER TABLE，会出现警告并且不会更改表。

启用 NO_ENGINE_SUBSTITUTION 后，如果所需的引擎不可用，则会发生错误并且不会创建或更改表。

所以：如果 NO_ENGINE_SUBSTITUTION 被禁用并且 INNODB 被关闭，如果你在 CREATE TABLE 语句中指定 INNODB，MySql 也会切换到 MISAM。
如果您正在创建的表适用于 MISAM，您只会收到警告并创建表。那不是你的情况，你的创建语句包含一个超出MYISAM 1000字节限制的索引，然后创建失败，错误1071报告MYISAM错误。那是因为工作引擎是MYISAM，而不是INNODB。

证明

MySql 5.1.56 社区版

情况1：

Options in my.cnf  
sql-mode=""  
default-storage-engine=MYISAM  
skip-innodb uncommented (without#) 

Return on execution of your create statement:
Error Code: 1071. Specified key was too long; max key length is 1000 bytes

Explanation: INNODB is not active, the engine is automatically switched to MYISAM  
that returns this error as they key is longer than MYISAM 1000 bytes limit.  
The key length is: 
2 fields x 255 char x 3 bytes utf8 encoding + 2 x 1 length byte = 1532 bytes

案例二：

Options in my.cnf
sql-mode="NO_ENGINE_SUBSTITUTION"
default-storage-engine=MYISAM
skip-innodb uncommented (without#)

Return on execution of your create statement:
Error Code: 1286. Unknown table engine 'INNODB'

Explanation: INNODB is not active but the engine substitution is not permitted
by sql mode therefore the DB returns an error about the attempt of using a disabled engine.

案例3：

Options in my.cnf
sql-mode="NO_ENGINE_SUBSTITUTION"
default-storage-engine=MYISAM
skip-innodb commented (with#)

Return on execution of your create statement:
Table creation OK!

Explanation: INNODB is active (skip-innodb commented) and it is used also if      
the default engine is MYISAM.

为了重现测试，在 my.cnf 中的每次更改后重新启动 MySql。

由于MySql 5.6版本的sqlmode默认不再为空并且包含NO_ENGINE_SUBSTITUTION，而且INNODB是默认引擎，所以这个错误很难遇到。

其他测试

没有其他方法可以重现错误：

Error Code: 1071. Specified key was too long; max key length is 1000 bytes

在尝试创建 INNODB 表时发现。

在 INNODB 中有两种 ERROR 1071：

Error Code: 1071. Specified key was too long; max key length is 767 bytes

这与 innodb_large_prefix ON 或 OFF 无关，而仅与用作索引的单个 VARCHAR 列的大小有关。

Mysql 将 varchar utf8 存储为 3 个字节加上 1 个字节，长度最多为 255 个字符，后面为 2 个（参见：http ://dev.mysql.com/doc/refman/5.7/en/storage-requirements.html ），所以如果你尝试使用 VARCHAR(256) utf8 设置密钥，您会得到：

256 x 3 + 2 = 770 bytes

并且您会收到上一个错误，因为 InnoDB 表的单个列的最大键长度为 767 字节。一个 VARCHAR(255) 是可以的，因为：

255 x 3 + 1 = 766 bytes

我在 Mysql 的 5.1.56、5.5.33、5.6 和 5.7 四个版本上对其进行了测试，并得到了证实。使用 VARCHAR(255) 查询没有问题，使用 VARCHAR(256) 有问题：

Error Code: 1071. Specified key was too long; max key length is 767 bytes

如您所见，消息不同，因为它是 INNODB 消息而不是 MISAM 消息！

INNODB 表的另一种类型的 ERROR 1071 是：

Error Code: 1071. Specified key was too long; max key length is 3072 bytes

这与具有多列的键有关。要启用这些键，您需要将 innodb_large_prefix 设置为 on。无论如何，如果你尝试运行这样的东西：

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key1` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key2` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id` , `module_id`, `action_name_key`, `action_name_key1`, `action_name_key2` )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

使用 5 个 VARCHAR(255) utf8 列的键，即 3830 字节，您将遇到：

Error Code: 1071. Specified key was too long; max key length is 3072 bytes

外来假设

在寻找原因的过程中，我制定并测试了不同且非常奇怪的假设：

行格式

已测试 REDUNDANT、COMPACT、COMPRESS、DYNAMIC：对您的语句创建表没有影响。

文件格式

测试过的羚羊和梭子鱼：您的语句对表创建没有影响。

MySql 构建

测试 32 位和 64 位 MySql：对您的语句创建表没有影响。

其他类似故障

在这里您可以在相同的情况下找到相同的错误：

https://www.drupal.org/node/2466287

我在证明中列出的 3 种测试情况下测试了该语句，它重现了与您完全相同的行为，所以我可以说问题是相同的。在那种情况下，他们切换到其他数据库，但问题是设置的混合，而不是数据库版本。

参考

这里给出了一篇非常好的使用 INNODB 进行索引的文章：

http://mechanics.flite.com/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071/

警告：通过在创建索引超过 1000 的 INNODB 表后取消注释 my.cnf 中的 skip-innodb 来禁用 INNODB 将不允许启动 MySql 服务

问候

score 3 · Accepted Answer

我现在不知道你有多少灵活性，但这里有一些选择：

将 MySQL 版本升级到最新版本（我在 MySQL 5.5.25 上测试了代码，没有出现错误。）
从 utf8 更改为 latin1。
减小构成主键的字段的大小。创建一个单独的 auto_increment 主键字段来替换现有的键。action_id 在第一个字段（但不是第二个字段）上创建单独的索引

除了这些选项之外，您几乎被卡住了，因为在 MySQL 中没有可以更改的设置来启用大于 1000 字节的索引键。

score 3 · Accepted Answer

在 MySQL 5.6.3+ 中，有一些限制（需要和） ROW_FORMAT=DYNAMIC，您可以启用3072 字节的密钥长度限制。innodb_file_format=BARRACUDAinnodb_file_per_table=trueinnodb_large_prefix

score 2 · Accepted Answer

你（不小心？）关闭了 InnoDB。它将表创建为 MyISAM，整个密钥超过 1000 个字节。

检查你是否有 InnoDB 的变量，以及是否有“no_engine_substitution”（如果在 5.1.56 中存在的话）还要检查mysqld.err它在启动时是否有一些相关的错误。

score 1 · Accepted Answer

它似乎与存储引擎有关。我的最终用户正在使用MyISAM它以不同方式处理数据存储，从而导致该错误。

score 1 · Accepted Answer

如前所述，索引的总长度太长。

简短的回答是无论如何您都不应该为这么长的VARCHAR列建立索引，因为索引会非常庞大且效率低下。

最佳做法是使用前缀索引，因此您只索引数据的左子字符串。无论如何，您的大部分数据都将比 255 个字符短得多。

767 字节是表的规定前缀限制InnoDB- 表的长度为 1,000 字节MyISAM。

根据对此问题的回复，您可以通过指定列的子集而不是整个金额来获取要应用的密钥。意味着您可以在定义索引时声明每列的前缀长度。

例如：

KEY `key_name` (`action_id`(50),`module_id`(50))

这是一个更清楚地解释它的示例：我创建了一个表并在其中插入了一些数据。

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id`(50) , `module_id`(50) )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

但是给定列的最佳前缀长度是多少？下面是一种查找方法：

SELECT
 ROUND(SUM(LENGTH(`action_id`)<10)*100/COUNT(*),2) AS pct_length_10,
 ROUND(SUM(LENGTH(`action_id`)<20)*100/COUNT(*),2) AS pct_length_20,
 ROUND(SUM(LENGTH(`action_id`)<50)*100/COUNT(*),2) AS pct_length_50,
 ROUND(SUM(LENGTH(`action_id`)<100)*100/COUNT(*),2) AS pct_length_100
FROM `phppos_modules_actions`;


+---------------+---------------+---------------+----------------+
| pct_length_10 | pct_length_20 | pct_length_50 | pct_length_100 |
+---------------+---------------+---------------+----------------+
|         42.86 |         80.20 |        100    |         100    |
+---------------+---------------+---------------+----------------+

这告诉您 80% 的字符串少于 20 个字符，并且所有字符串少于 50 个字符。所以不需要索引超过 50 个前缀长度，当然也不需要索引 255 个字符的全长。

根据需要进行调整以获取应用密钥，但我想知道是否值得审查有关此实体的数据模型，以查看是否有改进可以让您在不达到 MySQL 限制的情况下实施预期的业务规则。

有关 innodb 设置的一些替代方法可以在http://mechanics.flite.com/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071/找到

score 0 · Accepted Answer

官方文档 5.6

InnoDB表的限制

InnoDB 内部最大密钥长度为 3500 字节，但 MySQL 本身将其限制为 3072 字节。此限制适用于多列索引中组合索引键的长度。

http://dev.mysql.com/doc/refman/5.7/en/innodb-restrictions.html

MyISAM存储引擎

最大密钥长度为 1000 字节。这也可以通过更改源并重新编译来更改。对于长度超过 250 字节的密钥，使用比默认值 1024 字节更大的密钥块大小。

http://dev.mysql.com/doc/refman/5.7/en/myisam-storage-engine.html

但是，您的表被声明为 InnoDB。所以我不知道该怎么想

这个老bug的最后还有一个线索

如果您需要这个，您应该真正查看 MySQL 5.5 和从 5.5.14（2011 年 7 月）开始可用的 innodb_large_prefix 选项，因为它可能满足您的需求：

“启用此选项以允许索引键前缀超过 767 字节（最多 3072 字节），用于使用 DYNAMIC 和 COMPRESSED 行格式的 InnoDB 表。（创建此类表还需要选项值 innodb_file_format=barracuda 和 innodb_file_per_table=true。）有关各种设置下与索引键前缀关联的相关最大值，请参阅第 13.3.15 节，“InnoDB 表的限制”。

score 0 · Accepted Answer

最大密钥长度为 1000 字节。这也可以通过更改源并重新编译来更改。对于长度超过 250 字节的密钥，使用比默认值 1024 字节更大的密钥块大小。

score 0 · Accepted Answer

在我的例子中，MySQL 是在没有 InnoDB 支持的情况下启动的。在数据库备份导入期间 - 尝试创建 MyISAM 表。

同时，在 MySQL 重启过程中，控制台中没有显示错误。
只有在检查 MySQL 日志文件时 - 才发现这个。

顺便说一句，错误与相关innodb_log_file_size = 4G，仅当将其更改为innodb_log_file_size = 1G- 启用 InnoDB 支持时。