PostgreSQL 23514 en base de datos: la fila incumple una restricción CHECK

Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.

1. 1

   Restricción y tabla afectadas

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   lee los campos Constraint name (n) y Table name (t) del error en tu driver.

   Resultado que importa:

   el nombre de la restricción y su tabla.

   Si el driver los muestra:

   tienes la regla exacta; pasa a leer su definición.

   Si no los muestra:

   busca el nombre en el texto del mensaje o en el registro del servidor.

   Evidencia a conservar:

   nombre de la restricción, tabla y hora.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes · PostgreSQL error and notice fields

2. 2

   Condición frente a los valores enviados

   Requiere herramientas

   Quién:

   tú, como desarrollador.

   Cómo:

   obtén la definición de la restricción y evalúa su expresión con los valores de la fila rechazada, usando datos anonimizados.

   Resultado que importa:

   qué valor hace falsa la expresión.

   Si un valor incumple la regla:

   confirma un dato incorrecto en origen; corrígelo antes de enviarlo.

   Si los valores parecen válidos:

   apunta a una regla que cambió o que depende de una función modificada.

   Evidencia a conservar:

   definición de la restricción y valor que falla.

   Consulta la definición en modo lectura. No desactives ni elimines la restricción para que pase la fila: no lo hagas sin aprobación del responsable del esquema.

   Evidencia: PostgreSQL constraints

3. 3

   Lo que puede hacer quien rellena el formulario

   Sin herramientas especiales

   Quién:

   quien usa la aplicación.

   Cómo:

   revisa los valores que introdujiste (importes, fechas, cantidades) y si la aplicación indica algún límite.

   Resultado que importa:

   si algún campo está fuera de rango.

   Si corriges el valor y se guarda:

   confirma que era el dato.

   Si el valor es correcto y sigue fallando:

   indica una regla mal definida; avisa al soporte con la hora.

   Evidencia a conservar:

   captura de los valores y del mensaje.

   Evidencia: PostgreSQL constraints

Un código solo tiene significado dentro del producto y la versión correctos.

El apéndice A asigna 23514 a check_violation, en la clase 23 (violación de restricción de integridad). Una restricción CHECK se cumple si su expresión da verdadero o nulo, y se evalúa en el momento de insertar o modificar la fila, sin esperar al final de la transacción. Para la clase 23 el servidor incluye el nombre de la restricción y de la tabla en campos separados. El código señala qué regla se incumplió, no quién envió el dato incorrecto.

• Precauciónadvertencia editorial

  No elimines la restricción para guardar la fila: la regla protege la coherencia de los datos y, al volver a crearla, las filas que la incumplan harán fallar la operación.

  Evidencia: PostgreSQL constraints

1. 1

   PostgreSQL 18 Appendix A: Error Codes

   PostgreSQL Global Development Group · 2026 · official_doc

2. 2

   PostgreSQL constraints

   PostgreSQL Global Development Group · 2026 · official_doc