Erro do MySQL 1071: A chave especificada era muito longa
Um índice é mais largo do que o InnoDB permite (3072 bytes, ou 767 bytes com formatos de linha mais antigos), normalmente em um VARCHAR utf8mb4 longo.
- Número do erro
1071- Nome
ER_TOO_LONG_KEY- SQLSTATE
42000- Categoria
- Chaves e restrições
O que significa
O comprimento máximo da chave conta bytes, não caracteres. Com utf8mb4 cada caractere pode ocupar 4 bytes, então VARCHAR(255) precisa de até 1020 bytes por coluna. InnoDB com o DYNAMIC ou COMPRESSED formato de linha permite 3072 bytes por índice; os formatos antigos COMPACT e REDUNDANT permitem 767, que é onde VARCHAR(255) em utf8mb4 falha.
Causas comuns
- Um índice único em um
utf8mb4VARCHAR, especialmente no MySQL 5.6 ou com um formato de linha antigo. - Um índice composto cujas colunas somam mais do que o limite.
Como corrigir
-
Use o
DYNAMICformato de linha (o padrão desde o MySQL 5.7).ALTER TABLE users ROW_FORMAT = DYNAMIC;
-
Indexar um prefixo da coluna, o que funciona para índices não exclusivos.
CREATE INDEX idx_users_bio ON users (bio(191));
-
Encurte a coluna se valores longos não forem necessários, por exemplo
VARCHAR(191)para um e-mail indexado emutf8mb4dentro do limite de 767 bytes.
Erros relacionados
Mais erros de chaves e restrições
1062Entrada duplicada para chave1452Falha na chave estrangeira: não é possível adicionar a linha filha1451Falha na chave estrangeira: não é possível excluir a linha pai1216Não é possível adicionar ou atualizar uma linha filha1217Não é possível excluir ou atualizar a linha pai1215Não é possível adicionar restrição de chave estrangeira3780As colunas da chave estrangeira são incompatíveis1822Índice ausente para restrição de chave estrangeira
O código e o texto da mensagem são de Referência de mensagens de erro do MySQL 8.4. Veja toda a Lista de erros do MySQL ou pesquise todos os erros do banco de dados.
Trabalhe com MySQL no SQLly
Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o MySQL e os outros bancos de dados que você usa.