// Referência de erro do PostgreSQL

PostgreSQL 40001: não foi possível serializar o acesso

Em REPEATABLE READ ou SERIALIZABLE, uma transação concorrente alterou dados dos quais esta depende. O PostgreSQL a reverteu; tente novamente toda a transação.

SQLSTATE
40001
Nome
serialization_failure
Categoria
Rollback de Transação
Mensagem de erro
could not serialize access due to concurrent update

O que significa

Os níveis de isolamento mais altos do PostgreSQL prometem que uma transação verá um instantâneo consistente. Quando manter essa promessa é impossível porque outra transação confirmou uma alteração conflitante, o PostgreSQL aborta uma delas com 40001 em vez de retornar um resultado que não poderia ocorrer em uma ordem serial.

As mensagens variam conforme a causa: could not serialize access due to concurrent update ou concurrent delete (uma linha que você tentou alterar foi alterada por outra pessoa após seu instantâneo), e could not serialize access due to read/write dependencies among transactions (SERIALIZABLE detectou um padrão perigoso). A solução é a mesma: execute a transação novamente desde o início.

Causas comuns

  • Dois REPEATABLE READ ou SERIALIZABLE transações atualizam a mesma linha; a segunda a ser confirmada falha.
  • A SERIALIZABLE transação lê linhas que outra transação alterou em seguida, em um padrão que pode produzir uma anomalia.
  • Linhas quentes, como um contador ou saldo, atualizadas por muitas transações serializáveis concorrentes.

Como corrigir

  1. Tente novamente. Código que usa REPEATABLE READ ou SERIALIZABLE deve capturar SQLSTATE 40001 e executar toda a transação novamente, incluindo suas leituras, algumas vezes com um pequeno intervalo.

  2. Mantenha as transações serializáveis curtas e toque no menor número possível de linhas.

  3. Se você não precisa de serializabilidade para este trabalho, o nível padrão READ COMMITTED re-lê a versão mais recente da linha ao atualizar em vez de falhar.

    BEGIN ISOLATION LEVEL READ COMMITTED;
    UPDATE counters SET n = n + 1 WHERE name = 'visits';
    COMMIT;
  4. Em SERIALIZABLEdeclare transações somente leitura como tais; SERIALIZABLE READ ONLY DEFERRABLE nunca falha com erro de serialização.

    BEGIN ISOLATION LEVEL SERIALIZABLE READ ONLY DEFERRABLE;

Reproduza com segurança

Execute em duas conexões separadas em um banco de dados descartável.

-- 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;

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.