re:re:actable
Урок 023 минуты чтения

Что такое constraints

На этой странице
Кратко

Constraints (ограничения) — правила целостности, которые база проверяет при каждой вставке и изменении и отклоняет операцию при нарушении. Основные: NOT NULL, PRIMARY KEY, UNIQUE, FOREIGN KEY, CHECK, DEFAULT (строго говоря, значение по умолчанию, а не ограничение) и в PostgreSQL — EXCLUDE. Ограничения — последняя линия защиты: валидация в приложении может быть обойдена другим сервисом, скриптом или гонкой двух запросов, а база гарантирует правило всегда. Ограничениям дают понятные имена: по имени из ошибки (23505 unique_violation, orders_total_check) приложение превращает исключение в осмысленный ответ API.

Вопрос

Что такое constraints и зачем они нужны?

Виды ограничений

ОграничениеГарантирует
NOT NULLЗначение обязательно
PRIMARY KEYУникальный и не-NULL идентификатор строки
UNIQUEНет повторов значения или набора столбцов
FOREIGN KEYСсылка указывает на существующую строку
CHECKЗначение удовлетворяет условию
EXCLUDE (PostgreSQL)Нет пересекающихся строк по оператору (например, интервалы бронирований)

Пример

CREATE TABLE orders (
  id         bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  user_id    bigint NOT NULL,
  status     text   NOT NULL DEFAULT 'new',
  total      numeric(12, 2) NOT NULL,
  promo_code text,
  created_at timestamptz NOT NULL DEFAULT now(),
 
  CONSTRAINT orders_user_fk      FOREIGN KEY (user_id) REFERENCES users (id),
  CONSTRAINT orders_status_check CHECK (status IN ('new', 'paid', 'shipped', 'cancelled')),
  CONSTRAINT orders_total_check  CHECK (total >= 0),
  CONSTRAINT orders_promo_uniq   UNIQUE (user_id, promo_code)
);

Почему не только валидация в приложении

Запрос A: проверил, что email свободен → INSERT
Запрос B: проверил, что email свободен → INSERT     ← гонка: два одинаковых email

Проверка «SELECT, потом INSERT» не защищает от конкурентных запросов — UNIQUE защищает.

Обработка ошибок в приложении

try {
  await db.query("INSERT INTO users (email) VALUES ($1)", [email]);
} catch (e) {
  if (e.code === "23505" && e.constraint === "users_email_key") {
    throw new ConflictException("Email уже зарегистрирован");
  }
  throw e;
}
SQLSTATEОшибка
23502not_null_violation
23503foreign_key_violation
23505unique_violation
23514check_violation
23P01exclusion_violation

Добавление ограничения к большой таблице

-- без долгой блокировки: сначала только для новых строк
ALTER TABLE orders ADD CONSTRAINT orders_total_check CHECK (total >= 0) NOT VALID;
-- затем проверка старых строк без блокировки записи
ALTER TABLE orders VALIDATE CONSTRAINT orders_total_check;

Отложенная проверка

ALTER TABLE employees
  ADD CONSTRAINT employees_manager_fk FOREIGN KEY (manager_id) REFERENCES employees (id)
  DEFERRABLE INITIALLY DEFERRED;   -- проверяется при COMMIT, а не на каждой команде

Полезно для циклических ссылок и массовых перестановок.

Частые ошибки

  • Полагаться только на валидацию в коде.
  • Безымянные ограничения — непонятные ошибки в логах.
  • NOT NULL забыт на обязательных полях — «грязные» данные копятся годами.
  • Добавлять CHECK/FK к большой таблице без NOT VALID.

Что важно помнить

  • Ограничения гарантируют целостность независимо от приложения.
  • Только база защищает от гонок при проверке уникальности.
  • Имена ограничений — часть контракта с приложением.

Мини-шпаргалка

  • NOT NULL, PRIMARY KEY, UNIQUE, FOREIGN KEY, CHECK, EXCLUDE.
  • CONSTRAINT name ....
  • NOT VALID + VALIDATE CONSTRAINT.
  • DEFERRABLE INITIALLY DEFERRED.

Документация

PostgreSQL: Constraints, PostgreSQL: Error Codes.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам