// Referência de erro do SQLite

SQLITE_MISMATCH: incompatibilidade de tipo de dado

Um dos poucos lugares onde o SQLite é rigoroso com tipos: na maioria das vezes, definir um rowid ou uma coluna INTEGER PRIMARY KEY como algo que não seja um inteiro.

Código de resultado
SQLITE_MISMATCH
Nome
20
Categoria
Códigos de resultado primários
Mensagem de erro
datatype mismatch

O que significa

Normalmente, o SQLite permite que você armazene qualquer valor em qualquer coluna. SQLITE_MISMATCH (20) é retornado nos poucos casos em que ele insiste em um tipo. O que a documentação do SQLite destaca é o rowid: o rowid de uma tabela, e uma coluna declarada INTEGER PRIMARY KEY (que é um alias dele), deve conter um inteiro. Defini-lo como texto, como 'abc' ou um real não integral falha com datatype mismatch; NULL é permitido e escolhe o próximo inteiro disponível.

Erros de tipo em STRICT as tabelas são relatadas de forma diferente, como SQLITE_CONSTRAINT_DATATYPE.

Causas comuns

  • Inserindo um valor não inteiro, como uma string UUID, em um INTEGER PRIMARY KEY coluna.
  • Atualizando rowid para um valor de texto.
  • Migrando um esquema de outro banco de dados onde a coluna id era texto, mas declarando-o INTEGER PRIMARY KEY no SQLite.

Como corrigir

  1. Insira inteiros (ou NULL para permitir que o SQLite atribua um) em INTEGER PRIMARY KEY colunas.

    INSERT INTO users (id, name) VALUES (NULL, 'Ada');
  2. Se a chave realmente for texto, declare-a como chave primária de texto em vez disso.

    CREATE TABLE users (
        id   TEXT PRIMARY KEY,
        name TEXT NOT NULL
    );

Reproduza com segurança

CREATE TABLE t (id INTEGER PRIMARY KEY);
INSERT INTO t VALUES ('abc');   -- Runtime error: datatype mismatch (20)

Erros relacionados

Mais erros de códigos de resultado primá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.

// 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.