SQLITE_CONSTRAINT_UNIQUE: falha na restrição UNIQUE
Um INSERT ou UPDATE duplicaria um valor em uma coluna UNIQUE ou índice único. A mensagem indica a tabela e a coluna.
- Código de resultado
SQLITE_CONSTRAINT_UNIQUE- Nome
2067- Categoria
- Códigos de resultado estendidos
O que significa
O SQLite retorna SQLITE_CONSTRAINT_UNIQUE (2067) quando uma operação de escrita criaria duas linhas com o mesmo valor em uma UNIQUE restrição ou índice único. A mensagem lista as colunas, como table.column, separadas por vírgula para uma chave com várias colunas. Chaves primárias duplicadas são reportadas com SQLITE_CONSTRAINT_PRIMARYKEY mas usam o mesmo texto de mensagem.
NULLs não contam como duplicatas: uma coluna única pode conter qualquer número de NULLs.
Causas comuns
- Inserindo uma linha que já existe, por exemplo, ao reexecutar uma importação.
- Dois valores que diferem apenas em maiúsculas/minúsculas, em uma coluna declarada
COLLATE NOCASE. - Uma
UPDATEque define a coluna para um valor que outra linha já possui.
Como corrigir
-
Encontre a linha existente.
SELECT * FROM users WHERE email = '[email protected]';
-
Atualize a linha existente, com um upsert (SQLite 3.24 ou posterior).
INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada') ON CONFLICT (email) DO UPDATE SET name = excluded.name; -
Ou ignore duplicatas de propósito.
INSERT OR IGNORE INTO users (email, name) VALUES ('[email protected]', 'Ada');
Reproduza com segurança
CREATE TABLE users (email TEXT UNIQUE);
INSERT INTO users VALUES ('a@x');
INSERT INTO users VALUES ('a@x'); -- Runtime error: UNIQUE constraint failed: users.email (19)
Perguntas
Qual é a diferença entre INSERT OR REPLACE e um upsert?
INSERT OR REPLACE exclui a linha conflitante e insere uma nova, então colunas que você não forneceu são redefinidas e gatilhos de exclusão e ações de chave estrangeira podem ser acionados. Um upsert com ON CONFLICT DO UPDATE altera a linha existente no local.
Erros relacionados
SQLITE_CONSTRAINT_PRIMARYKEYfalha na restrição de CHAVE PRIMÁRIASQLITE_CONSTRAINTrestrição falhou23505PostgreSQL: chave duplicada viola a restrição de unicidade1062MySQL: entrada duplicada para a chave2627SQL Server: Violação de PRIMARY KEY ou UNIQUE KEY2601SQL Server: Não é possível inserir linha com chave duplicadaORA-00001Oracle: restrição de unicidade violada
Mais erros de códigos de resultado estendidos
SQLITE_ERROR_MISSING_COLLSEQsequência de collation inexistenteSQLITE_BUSY_RECOVERYoutro processo está recuperando o WALSQLITE_LOCKED_SHAREDCACHEregistro bloqueado no cache compartilhadoSQLITE_CONSTRAINT_CHECKfalha na restrição CHECKSQLITE_ABORT_ROLLBACKinstrução abortada por ROLLBACKSQLITE_BUSY_SNAPSHOTleitura obsoleta não pode se tornar uma escritaSQLITE_IOERR_SHORT_READleitura retornou menos bytesSQLITE_CANTOPEN_ISDIRo caminho é um diretório
O código e o texto da mensagem são de Documentação de códigos de resultado e erro do SQLite. Veja toda a Lista de erros do SQLite ou pesquise todos os erros do banco de dados.
Trabalhe com SQLite 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 SQLite e os outros bancos de dados que você usa.