// Referencia de errores de PostgreSQL

PostgreSQL 23514: violación de restricción CHECK

Una fila no pasó una restricción CHECK en la tabla, o una verificación de dominio, por lo que el INSERT o UPDATE fue rechazado.

SQLSTATE
23514
Nombre
check_violation
Categoría
Violación de restricción de integridad
Mensaje de error
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

Qué significa

A CHECK restricción es una condición que cada fila debe cumplir, como qty > 0. 23514 significa que la fila nueva o actualizada hizo falsa la condición. Una condición que dé como resultado NULL pasa, así que las comprobaciones no lo rechazan NULL valores por sí solos.

El mensaje indica la restricción; \d table_name en psql o pg_get_constraintdef muestra su condición. Añadir una restricción CHECK a una tabla con filas existentes incorrectas falla de la misma manera, con check constraint ... of relation ... is violated by some row.

Causas comunes

  • Datos fuera del rango o del conjunto permitido, por ejemplo una cantidad negativa o un estado desconocido.
  • Validación de la aplicación que difiere de las reglas de la base de datos.
  • Añadir una CHECK restricción a una tabla que ya tiene filas que la violan.
  • Un tipo de dominio con un CHECK (value for domain ... violates check constraint).

Cómo solucionarlo

  1. Lee la condición de la restricción.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. Corrige los datos que estás escribiendo para que cumplan la condición.

  3. Para añadir una restricción CHECK a una tabla con filas antiguas incorrectas, añádela NOT VALID (aplicado solo a filas nuevas), limpia los datos y luego valida.

    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;

Reprodúcelo de forma segura

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"

Errores relacionados

Más errores de violación de restricciones de integridad

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.