文档

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步操作。

  1. 登录RDS控制台,选择目标地域,单击目标实例ID,单击参数设置,将 innodb_large_prefix 值修改为ON,单击确定,然后单击提交参数即可。image..png

  2. 登录数据库,执行以下SQL语句,确认 innodb_large_prefix 值为 ON

    show variables like 'innodb_large_prefix';

    系统显示类似如下:返回结果

  3. 配置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

      2. 根据实际情况,执行其中一条SQL语句,修改 Row_format 值。

        alter table [$Table_Name] Row_format=dynamic;
        alter table [$Table_Name] Row_format=compressed;

  4. 使用前缀索引替代。

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));
  • 本页导读 (1)