// справочник ошибок PostgreSQL

PostgreSQL 23514: нарушение ограничения CHECK

Строка не прошла проверку ограничения CHECK в таблице или проверку домена, поэтому INSERT или UPDATE был отклонён.

SQLSTATE
23514
Имя
check_violation
Категория
Нарушение ограничения целостности
Сообщение об ошибке
new row for relation "orders" violates check constraint "orders_qty_check"
DETAIL:  Failing row contains (12, -1).

Что это значит

A CHECK ограничение — это условие, которому должна удовлетворять каждая строка, например qty > 0. 23514 означает, что новая или обновлённая строка сделала условие ложным. Условие, которое оценивается как NULL проходит, поэтому проверки его не отклоняют NULL значения сами по себе.

Сообщение называет ограничение; \d table_name в psql или pg_get_constraintdef показывает его условие. Добавление проверки к таблице с уже существующими некорректными строками приводит к такому же сбою, с check constraint ... of relation ... is violated by some row.

Распространённые причины

  • Данные вне допустимого диапазона или множества, например, отрицательное количество или неизвестный статус.
  • Валидация приложения, которая отличается от правил базы данных.
  • Добавление CHECK ограничение к таблице, в которой уже есть нарушающие его строки.
  • Тип домена с CHECK (value for domain ... violates check constraint).

Как исправить

  1. Прочитайте условие ограничения.

    SELECT conname, pg_get_constraintdef(oid)
    FROM pg_constraint
    WHERE conrelid = 'orders'::regclass AND contype = 'c';
  2. Исправьте записываемые данные так, чтобы они удовлетворяли условию.

  3. Чтобы добавить проверку к таблице со старыми некорректными строками, добавьте её NOT VALID (применяется только к новым строкам), очистите данные, а затем выполните проверку.

    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;

Безопасное воспроизведение

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"

Связанные ошибки

Больше ошибок нарушения ограничений целостности

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.