// Referência de erro do SQLite

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
Mensagem de erro
UNIQUE constraint failed: users.email

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 UPDATE que define a coluna para um valor que outra linha já possui.

Como corrigir

  1. Encontre a linha existente.

    SELECT * FROM users WHERE email = '[email protected]';
  2. 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;
  3. 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

Mais erros de códigos de resultado estendidos

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.

// menos erros, correções mais rápidas

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.