// Referência de erro do SQLite

SQLITE_CONSTRAINT_PRIMARYKEY: falha na restrição PRIMARY KEY

Um INSERT ou UPDATE duplicaria um valor de chave primária. A mensagem do SQLite ainda diz UNIQUE constraint failed e nomeia a coluna da chave.

Código de resultado
SQLITE_CONSTRAINT_PRIMARYKEY
Nome
1555
Categoria
Códigos de resultado estendidos
Mensagem de erro
UNIQUE constraint failed: orders.id

O que significa

SQLITE_CONSTRAINT_PRIMARYKEY (1555) é o código estendido para uma chave primária duplicada. O texto da mensagem é o mesmo de qualquer violação UNIQUE, UNIQUE constraint failed: table.column, e o código estendido é o que permite a um programa diferenciá-los.

Para uma INTEGER PRIMARY KEY coluna você pode deixar o valor de fora (ou passar NULL) e o SQLite atribui o próximo rowid, o que evita a maioria das colisões.

Causas comuns

  • Inserindo um id explícito que já existe.
  • Copiando linhas entre bancos de dados com seus ids, onde os intervalos se sobrepõem.
  • Gerando ids na aplicação com um esquema que pode se repetir.

Como corrigir

  1. Deixe o SQLite atribuir INTEGER PRIMARY KEY valores deixando a coluna de fora.

    INSERT INTO orders (customer_id, total) VALUES (42, 19.99);
    SELECT last_insert_rowid();
  2. Ao mesclar dados, faça upsert na chave ou ignore linhas existentes.

    INSERT INTO orders (id, customer_id, total)
    SELECT id, customer_id, total FROM other.orders WHERE true
    ON CONFLICT (id) DO NOTHING;

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.