// Referência de erro do PostgreSQL

PostgreSQL 23514: violação de restrição de verificação

Uma linha não passou em uma restrição CHECK na tabela, ou no check de um domínio, então o INSERT ou UPDATE foi rejeitado.

SQLSTATE
23514
Nome
check_violation
Categoria
Violação de restrição de integridade
Mensagem de erro
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

O que significa

A CHECK restrição é uma condição que cada linha deve satisfazer, como qty > 0. 23514 significa que a linha nova ou atualizada tornou a condição falsa. Uma condição que resulta em NULL passa, então as verificações não rejeitam NULL valores por si só.

A mensagem indica a restrição; \d table_name no psql ou pg_get_constraintdef mostra sua condição. Adicionar uma verificação a uma tabela com linhas inválidas já existentes falha da mesma forma, com check constraint ... of relation ... is violated by some row.

Causas comuns

  • Dados fora do intervalo ou conjunto permitido, por exemplo, uma quantidade negativa ou um status desconhecido.
  • Validação do aplicativo que difere das regras do banco de dados.
  • Adicionando uma CHECK restrição a uma tabela que já possui linhas que a violam.
  • Um tipo de domínio com um CHECK (value for domain ... violates check constraint).

Como corrigir

  1. Leia a condição da restrição.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. Corrija os dados que estão sendo gravados para que atendam à condição.

  3. Para adicionar uma verificação a uma tabela com linhas antigas inválidas, adicione-a NOT VALID (aplicada apenas para novas linhas), limpe os dados e depois valide.

    ALTER TABLE orders ADD CONSTRAINT orders_qty_check CHECK (qty > 0) NOT VALID;
    UPDATE orders SET qty = 1 WHERE qty <= 0;
    ALTER TABLE orders VALIDATE CONSTRAINT orders_qty_check;

Reproduza com segurança

CREATE TEMP TABLE o (qty int CHECK (qty > 0));
INSERT INTO o VALUES (-1);  -- ERROR: new row for relation "o" violates check constraint "o_qty_check"

Erros relacionados

Mais erros de violação de restrição de integridade

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

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

Trabalhe com PostgreSQL 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 PostgreSQL e os outros bancos de dados que você usa.