PostgreSQL: транзакции и целостность данных
Для чего веб-сервису транзакции, уникальные ключи и связи таблиц. Как отделить согласованность данных в PostgreSQL от надёжности внешнего обмена.
Когда веб-сервис хранит заявки, документы или задания, важно определить допустимое состояние данных. Можно ли сохранить строку заявки без самой заявки? Может ли одно внешнее событие создать две одинаковые записи? Какие изменения должны вступить в силу вместе?
PostgreSQL предоставляет механизмы, которыми разработчик может выразить часть этих правил. Их нужно связать с предметной областью: база не узнает смысл заявки или этапа работ без явно заданной модели.
01
Изменения, которые должны происходить вместе
Транзакция PostgreSQL объединяет несколько изменений в БД в операцию, которая применяется целиком или отменяется. В учебном разделе Transactions показаны границы BEGIN, COMMIT и ROLLBACK.
Рассмотрим условную внутреннюю заявку: нужно сохранить её состав и запись о переходе в состояние «передана на проверку». Если эти изменения относятся к одному действию, полезно сформулировать правило: после успешного завершения в базе есть и состав, и переход; после неуспеха нет частично выполненного действия.
Чтобы проверить правило, недостаточно пройти обычный путь через форму. В сценарий проверки стоит включить ошибку между шагами и повтор после неё. Ожидаемое состояние описывают заранее, иначе частичный результат легко принять за успешное завершение.
Это авторский пример модели данных, а не описание внедрённого клиентского проекта.
02
Идентичность и допустимые связи
PRIMARY KEY требует уникальных значений без NULL. В простом случае непустое значение FOREIGN KEY должно ссылаться на существующую строку другой таблицы. Эти свойства описаны в разделе Constraints.
В примере заявки сначала нужно решить, что именно идентифицируется: сама заявка, её версия или событие изменения. Если всё обозначить одним номером, станет трудно отличать новую версию от повторной доставки прежнего события.
Связь строки состава с заявкой задаёт ещё одно правило: строка не должна указывать на несуществующую заявку. Но допустимость изменения состава после передачи на проверку — уже отдельное условие рабочего процесса. Его также нужно выразить и проверить; наличие связи таблиц не описывает все переходы состояний.
Для ключа внешнего события определите область уникальности. Номер может быть уникален внутри одной системы, но совпадать у двух отправителей. Тогда в проверку идентичности нужно включить отправителя. Поле, по которому распознают обязательное событие, не стоит оставлять неопределённым.
03
Что делать при повторной вставке
При конфликте уникальности ON CONFLICT DO NOTHING позволяет пропустить вставку конфликтующей строки. Поведение этой конструкции приведено в документации INSERT.
Для интеграции это возможная часть обработки повтора. Однако сначала нужно определить, какой результат вернёт приложение и совпадают ли данные повторного запроса с исходными. Один и тот же ключ с другим содержимым требует отдельного решения. Молчаливый пропуск не должен скрывать подмену или ошибку отправителя.
Задание на такой обработчик содержит четыре пункта: ключ операции, проверку её содержания, изменения при первом получении и ответ при повторе. Затем эти условия проверяют и при последовательных, и при одновременных запросах.
04
Граница локальной транзакции
Разделяйте запись в PostgreSQL и действие в другой системе. Если после сохранения заявки нужно отправить внешнее уведомление, правило «оба шага находятся рядом в коде» ещё не объясняет восстановление после сбоя. Разберите два случая: запись сохранена, но отправки не было; отправка выполнена, но подтверждение потерялось.
Один из вариантов проектирования — сохранять намерение внешнего действия вместе с локальным изменением, а доставку выполнять отдельно с учётом повторов. Это предложение по архитектуре. Для его применения нужно проверить контракт приёмника, долговечность хранения, правила повторной обработки и способ сверки.
Если приёмник не позволяет узнать результат операции и не распознаёт повтор, нельзя обещать отсутствие дублей только за счёт настроек вашей БД. Такой пробел нужно назвать до согласования результата интеграции.
05
С чего начать модель данных
Составьте перечень утверждений о допустимом состоянии: что существует только вместе, какие ключи уникальны, какие ссылки обязательны и какие переходы запрещены. Рядом укажите способ проверки каждого правила.
Эта работа помогает определить, что должна обеспечивать база, что — приложение, а что зависит от внешнего API. После такого разделения проще обсуждать разработку сервиса и обмен данными.