阿里云首页 云数据库 RDS

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.

问题原因

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

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

解决方案

阿里云提醒您:

  • 如果您对实例或数据有修改、变更等风险操作,务必注意实例的容灾、容错能力,确保数据安全。
  • 如果您对实例(包括但不限于ECS、RDS)等进行配置与数据修改,建议提前创建快照或开启RDS日志备份等功能。
  • 如果您在阿里云平台授权或者提交过登录账号、密码等安全信息,建议您及时修改。

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

  1. 登录RDS控制台,选择目标地域,单击目标实例ID,单击参数设置,将innodb_large_prefix值修改为ON,单击确定,然后单击提交参数即可。
  2. 登录数据库,执行以下SQL语句,确认innodb_large_prefix值为ON。
    show variables like 'innodb_large_prefix';
    系统显示类似如下。
  3. 将innodb_large_prefix参数值修改为ON后,对于Dynamic和Compressed格式的InnoDB引擎表,其支持的最大索引字段长度为3072字节:
    说明:只支持DYNAMIC和COMPRESSED格式的表,compact格式的表不支持。
    • 创建表:指定表的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]为表名。
    • 对已经创建的表:
      1. 执行以下SQL语句,确认Row_format值不是DYNAMIC和COMPRESSED。
        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;

适用于

  • 云数据库RDS

如果您的问题仍未解决,您可以在阿里云社区免费咨询,或提交工单联系阿里云技术支持。

首页 云数据库 RDS 常见问题 SQL RDS MySQL创建索引时提示“Specified key was too long; max key length is 767 bytes”