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

PostgreSQL 40001: не удалось сериализовать доступ

При уровне изоляции REPEATABLE READ или SERIALIZABLE другая параллельная транзакция изменила данные, от которых зависит эта транзакция. PostgreSQL откатил её; повторите всю транзакцию.

SQLSTATE
40001
Имя
serialization_failure
Категория
Откат транзакции
Сообщение об ошибке
could not serialize access due to concurrent update

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

Более высокие уровни изоляции PostgreSQL гарантируют, что транзакция видит согласованный снимок данных. Когда выполнить это невозможно из-за того, что другая транзакция зафиксировала конфликтующее изменение, PostgreSQL прерывает одну из транзакций с кодом 40001, а не возвращает результат, который не мог бы получиться при последовательном выполнении.

Сообщения различаются в зависимости от причины: could not serialize access due to concurrent update или concurrent delete (строка, которую вы пытались изменить, была изменена кем-то другим после вашего снимка) и could not serialize access due to read/write dependencies among transactions (SERIALIZABLE обнаружил опасный шаблон). Лечение то же: повторите транзакцию с самого начала.

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

  • Два REPEATABLE READ или SERIALIZABLE транзакции обновляют одну и ту же строку; фиксация второй падает.
  • A SERIALIZABLE транзакция читает строки, которые другая транзакция затем меняет, — сценарий, способный привести к аномалии.
  • Горячие строки, такие как счётчик или баланс, обновляемые множеством одновременных сериализуемых транзакций.

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

  1. Повторите попытку. Код, который использует REPEATABLE READ или SERIALIZABLE должен ловить SQLSTATE 40001 и запускать всю транзакцию заново, включая чтение, несколько раз с короткой задержкой.

  2. Держите сериализуемые транзакции короткими и затрагивайте как можно меньше строк.

  3. Если вам не нужна сериализуемость для этой работы, уровень по умолчанию READ COMMITTED повторно считывает последнюю версию строки при обновлении вместо того, чтобы завершаться с ошибкой.

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. При SERIALIZABLEобъявляйте транзакции только для чтения как таковые; SERIALIZABLE READ ONLY DEFERRABLE никогда не завершится ошибкой сериализации.

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

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

Запускайте в двух отдельных соединениях на тестовой базе данных.

-- Session 1:
CREATE TABLE acct (id int PRIMARY KEY, bal int);
INSERT INTO acct VALUES (1, 100);
BEGIN ISOLATION LEVEL REPEATABLE READ;
SELECT bal FROM acct WHERE id = 1;
-- Session 2:
UPDATE acct SET bal = 50 WHERE id = 1;
-- Session 1:
UPDATE acct SET bal = bal - 10 WHERE id = 1;  -- ERROR: could not serialize access due to concurrent update
ROLLBACK;

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

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

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

Работа с PostgreSQL в SQLly

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