// Referência de erro do SQLite

SQLITE_CONSTRAINT_CHECK: falha na restrição CHECK

Uma linha falhou em uma expressão CHECK na tabela. A mensagem nomeia a restrição ou mostra a expressão quando a restrição não tem nome.

Código de resultado
SQLITE_CONSTRAINT_CHECK
Nome
275
Categoria
Códigos de resultado estendidos
Mensagem de erro
CHECK constraint failed: price_positive

O que significa

SQLITE_CONSTRAINT_CHECK (275) significa que um valor tornou uma CHECK expressão falsa. Nomeie suas restrições (CONSTRAINT price_positive CHECK (price > 0)) então a mensagem informa qual regra falhou; para uma restrição sem nome, versões recentes do SQLite imprimem a própria expressão.

Um CHECK que resulta em NULL passa, então CHECK (price > 0) não rejeita um preço NULL.

Causas comuns

  • Um valor fora do intervalo ou lista permitidos.
  • Texto que não corresponde a um padrão como CHECK (email LIKE '%@%').
  • Um CHECK escrito para emular um enum ou booleano, dado um valor inesperado.

Como corrigir

  1. Veja a definição da restrição.

    SELECT sql FROM sqlite_schema WHERE name = 'products';
  2. Corrija o valor ou altere a regra se os dados estiverem certos e a regra errada. O SQLite não altera um CHECK diretamente; reconstrua a tabela com a nova definição.

  3. Nomeie as restrições para que falhas sejam fáceis de ler.

    CREATE TABLE products (
        id    INTEGER PRIMARY KEY,
        price REAL NOT NULL CONSTRAINT price_positive CHECK (price > 0)
    );

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.