Erro do MySQL 1062: Entrada duplicada para a chave
Um INSERT ou UPDATE colocaria um valor que já existe em um índice PRIMARY KEY ou UNIQUE. A mensagem indica o valor e a chave.
- Número do erro
1062- Nome
ER_DUP_ENTRY- SQLSTATE
23000- Categoria
- Chaves e restrições
O que significa
O MySQL rejeita uma linha cujo valor em uma chave primária ou índice único coincide com uma linha que já existe. A mensagem mostra o valor duplicado e o índice, por exemplo Duplicate entry '[email protected]' for key 'users.email' (MySQL 8.0 e posteriores incluem o nome da tabela na chave).
Com um INSERT, as linhas antes do duplicado são mantidas em tabelas não transacionais como MyISAM, mas com InnoDB toda a instrução é revertida.
Causas comuns
- Reexecutando um script de importação ou seed que insere linhas que já estão presentes.
- Inserindo um id explícito que já existe, ou um
AUTO_INCREMENTcontador que foi configurado abaixo do máximo atual. - Uma
UPDATEque altera uma coluna única para um valor que outra linha possui. - Um índice único em uma coluna com um collation que não diferencia maiúsculas de minúsculas:
[email protected]e[email protected]contam como o mesmo valor.
Como corrigir
-
Veja a linha que já contém o valor.
SELECT * FROM users WHERE email = '[email protected]';
-
Para atualizar a linha existente, use
INSERT ... ON DUPLICATE KEY UPDATE. No MySQL 8.0.19 ou mais recente, referencie os novos valores por um alias de linha; versões mais antigas usamVALUES(name), que ainda funciona, mas está obsoleto.INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') AS new ON DUPLICATE KEY UPDATE name = new.name; -
Para pular duplicatas de propósito, use
INSERT IGNORE. Ele transforma o erro em aviso, junto com alguns outros erros, então confiraSHOW WARNINGSdepois.INSERT IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada'); -
Se a duplicata estiver em
AUTO_INCREMENT, verifique o contador em relação aos dados.SELECT MAX(id) FROM users; SHOW CREATE TABLE users; -- shows AUTO_INCREMENT=n
Reproduza com segurança
CREATE TEMPORARY TABLE t (id INT PRIMARY KEY); INSERT INTO t VALUES (1); INSERT INTO t VALUES (1); -- ERROR 1062 (23000): Duplicate entry '1' for key 't.PRIMARY'
Perguntas
Como descubro em qual chave está a duplicata?
A mensagem indica: for key 'PRIMARY' é a chave primária, qualquer outro é o nome de um índice único. SHOW INDEX FROM table_name; lista os índices e suas colunas.
Erros relacionados
1452Falha na chave estrangeira: não é possível adicionar a linha filha1048Coluna não pode ser nula1586Entrada duplicada para chave (com nome da chave)23505PostgreSQL: chave duplicada viola a restrição de unicidade2627SQL Server: Violação de PRIMARY KEY ou UNIQUE KEYORA-00001Oracle: restrição de unicidade violadaSQLITE_CONSTRAINT_UNIQUESQLite: Falha na restrição UNIQUE
Mais erros de chaves e restrições
1061Nome de chave duplicado1451Falha 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 estrangeira1824Falha ao abrir a tabela referenciada
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.