RDS MySQL创建索引时提示“Specified key was too long; max key length is 767 bytes”

问题描述

阿里云云数据库RDS MySQL版在创建表索引时，出现如下错误信息：

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

ERROR 1709 (HY000): Index column size too large. The maximum column size is 767 bytes.

适用场景

适用于RDS MySQL 5.6/5.7/8.0 全规格产品。

问题原因

由于MySQL的InnoDB引擎表索引字段长度的限制为767字节，因此对多字节字符集的大字段或者多字段组合，在创建索引时会出现该问题。

说明

以utf8mb4字符集的字符串类型字段为例，utf8mb4是4个字节字符集，默认支持的索引字段最大长度是191字符（767字节/4字节每字符≈191字符），因此在 varchar(255) 或 char(255) 类型字段上创建索引会失败，详情请参见MySQL官网文档。

解决方案

请参考以下内容，将innodb_large_prefix参数值修改为ON，修改后对于Dynamic和Compressed格式的InnoDB引擎表，其支持的最大索引字段长度为3072字节。

说明

在MySQL 8.0中已经删除了innodb_large_prefix参数，可通过调整数据表的Row_format值来解决，具体操作请参见第3步操作。

登录RDS控制台，选择目标地域，单击目标实例ID，单击参数设置，将 innodb_large_prefix 值修改为ON，单击确定，然后单击提交参数即可。
登录数据库，执行以下SQL语句，确认 innodb_large_prefix 值为 ON。
```
show variables like 'innodb_large_prefix';
```
系统显示类似如下：
配置Row Format。
说明
- 将innodb_large_prefix参数值修改为ON后，对于Dynamic和Compressed格式的InnoDB引擎表，其支持的最大索引字段长度为3072字节。
- 只支持DYNAMIC和COMPRESSED格式的表，compact格式的表不支持。
1. 创建表时配置：指定表的Row Format为Dynamic或Compressed，示例如下：
```
create table [$Table_Name] (id int auto_increment primary key, name varchar(255)) ROW_FORMAT=DYNAMIC default charset utf8mb4;
```
  说明
  [$Table_Name]为表名。
2. 修改已有表配置。
  执行以下SQL语句，查看Row_format取值，如果取值不是DYNAMIC和COMPRESSED，则执行后续步骤修改取值。
  1. ```
  show table status like '[$Table_Name]'\G
```
  系统显示类似如下：
2. 根据实际情况，执行其中一条SQL语句，修改 Row_format 值。
```
  alter table [$Table_Name] Row_format=dynamic;
  alter table [$Table_Name] Row_format=compressed;
```
使用前缀索引替代。

alter table [$Table_Name] add key(column_name(prefix_len));
alter table [$Table_Name] add index idx_name(name(100));
-- 或 create index index_name on [$Table_Name](column_name(prefix_len));