В реляционных базах данных проверка уникальности опирается на оператор равенства, но в трехзначной логике SQL выражение NULL = NULL возвращает NULL, а не истину. Из-за этого в PostgreSQL стандартные ограничения UNIQUE и уникальные B-tree индексы по умолчанию считают каждое значение NULL уникальным: таблица без ошибок примет дубликаты вида (1, 10, NULL).
При реализации мягкого удаления (soft delete), когда активные строки помечаются как deleted_at IS NULL, такое поведение ломает бизнес-правило «одна активная запись на сущность».
Начиная с версии PostgreSQL 15 доступна опция NULLS NOT DISTINCT:
CREATE UNIQUE INDEX users_email_idx ON users (email) NULLS NOT DISTINCT;
В таком индексе СУБД считает все NULL эквивалентными и разрешает сохранить ровно одну такую строку.
Однако для soft delete этот синтаксис не подходит: он заблокирует любые совпадающие комбинации в удаленных записях. Для мягкого удаления корректным решением остается частичный уникальный индекс (partial index):
CREATE UNIQUE INDEX memberships_active_idx ON memberships (user_id, org_id) WHERE deleted_at IS NULL;
Он обеспечивает уникальность только среди активных записей, не ограничивая историю удалений.
