Ir para o conteúdo
Promovaweb

Transações e concorrência

Uma compra que baixa o estoque e registra a venda não pode parar no meio, com o estoque baixado e a venda perdida. A transação agrupa essas alterações, que o PostgreSQL confirma com COMMIT ou descarta com ROLLBACK. O controle de concorrência por múltiplas versões (MVCC) permite que consultas comuns leiam versões confirmadas das linhas enquanto outra transação as altera.

Ficha e sumário da página

Referência técnica
PostgreSQL 18.7
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. A compra e o estoque na mesma transação
  2. MVCC: versões em vez de travas de leitura
  3. Os níveis de isolamento
  4. Travas e deadlocks

A compra e o estoque na mesma transação

A documentação usa uma transferência bancária para explicar a transação: o débito de um lado e o crédito do outro precisam acontecer juntos. Num app, a mesma situação aparece quando uma compra grava a linha da compra, os itens e a baixa no estoque. Se o servidor cair entre o segundo e o terceiro comando, o estoque fica errado, a menos que os três comandos estejam na mesma transação.

  1. Abertura

    BEGIN

    A conexão abre um bloco para agrupar os comandos seguintes.

  2. Compra

    INSERT INTO compras

    A linha nova existe só para esta conexão.

  3. Estoque

    UPDATE produtos

    A linha do produto fica travada para outras gravações até o fim.

  4. Confirmação

    COMMIT

    Confirma as alterações para outras transações. ROLLBACK as descarta.

Uma compra gravada numa transação. As linhas novas só ficam visíveis para as outras conexões no COMMIT. Um erro em qualquer etapa leva ao ROLLBACK, que desfaz as etapas anteriores.

O PostgreSQL trata todo comando SQL como parte de uma transação. Sem BEGIN, cada comando recebe um BEGIN e um COMMIT implícitos, de modo que um UPDATE solto já vale por inteiro ou não vale. O bloco explícito serve para agrupar vários comandos. Muitos drivers e ORMs abrem esse bloco por você, como o DB::transaction do Laravel, que faz o COMMIT quando a função termina e o ROLLBACK quando ela lança uma exceção.

O SAVEPOINT marca um ponto intermediário dentro da transação. Um ROLLBACK TO SAVEPOINT desfaz só o que veio depois da marca e mantém o restante, útil quando um passo opcional falha e o resto da compra continua válido.

MVCC: versões em vez de travas de leitura

O PostgreSQL controla a concorrência com múltiplas versões das linhas. Um UPDATE cria uma versão nova e mantém a anterior enquanto ela ainda pode ser necessária. O snapshot define quais versões cada consulta enxerga. No nível padrão, Read Committed, um SELECT comum vê as alterações confirmadas antes do início da consulta e as alterações anteriores da própria transação. As travas de linha das gravações não fazem esse SELECT esperar. Comandos como ALTER TABLE e leituras com FOR UPDATE têm outras exigências de trava.

Na prática, um relatório pesado no Metabase lê a tabela de compras enquanto o app grava compras novas, sem que um espere pelo outro. O relatório vê as compras confirmadas até o início da própria consulta. As gravações seguem normalmente e aparecem na próxima execução do relatório.

As versões antigas não somem sozinhas. Quando nenhuma transação aberta precisa mais delas, o VACUUM libera o espaço para reutilização pela tabela, tarefa que o daemon de autovacuum executa na maioria das instalações. Uma transação longa que mantém um snapshot antigo ou um identificador de transação atribuído pode atrasar essa limpeza. Enquanto as versões ainda forem necessárias, o servidor preserva as linhas antigas. A visão pg_stat_activity mostra idle in transaction quando a conexão está parada dentro de uma transação aberta.

Os níveis de isolamento

O padrão SQL define quatro níveis de isolamento. O PostgreSQL aceita os quatro nomes, mas implementa três, porque o Read Uncommitted se comporta como o Read Committed. O nível padrão é o Read Committed.

NívelO que cada comando enxergaO que o app precisa tratar
Read CommittedUm SELECT comum vê o que estava confirmado no início da consulta e as próprias alterações anteriores.Duas leituras iguais na mesma transação podem trazer valores diferentes.
Repeatable ReadO que estava confirmado no início do primeiro comando de consulta ou alteração, além das próprias alterações.Falhas de serialização, que exigem repetir a transação desde o início.
SerializableUm resultado igual ao de alguma ordem em série das transações concorrentes.Pode recusar execuções sem uma ordem serial equivalente. O app repete a transação inteira.

No Read Committed, uma leitura do saldo seguida de uma gravação calculada no app pode perder uma atualização de outra conexão no intervalo. O SELECT ... FOR UPDATE resolve esse caso travando a linha lida até o fim da transação. Os níveis Repeatable Read e Serializable detectam o conflito e cancelam uma das transações com erro de serialização. A documentação avisa que o app que usa esses níveis precisa estar preparado para repetir a transação.

Travas e deadlocks

Consultas comuns usam as versões das linhas sem disputar as travas de linha das gravações, mas dois comandos que alteram a mesma linha ainda se enfileiram. O segundo UPDATE espera o COMMIT ou o ROLLBACK do primeiro antes de continuar. Quando duas transações esperam uma pela outra, cada uma segurando a linha que a outra quer, o servidor detecta o deadlock e cancela uma delas com erro.

Esse erro chega ao app como qualquer outro. Transações curtas, que travam as linhas numa ordem fixa, reduzem a chance de deadlock. Chamadas de rede dentro de uma transação aberta, como esperar a resposta de um gateway de pagamento, seguram travas pelo tempo da chamada inteira e aumentam a fila de gravações atrás delas.

O estado de cada transação aparece na visão pg_stat_activity. A coluna xact_start mostra quando a transação começou. A coluna state indica se a conexão está executando um comando ou parada dentro de uma transação aberta. Uma linha com idle in transaction há vários minutos identifica uma conexão que abriu a transação e não a encerrou. Você relaciona o usuário, o application_name e a última consulta com os logs do app para localizar o trecho de código.

Continue na comunidade

Leve ao Discord da Promovaweb a consulta lenta ou o erro de limite de conexões. Com o EXPLAIN ou a mensagem do servidor na conversa, a comunidade compara o seu caso com bancos parecidos.

Uma VPS para o seu PostgreSQL

Cada conexão do PostgreSQL ocupa um processo com memória própria no servidor. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o banco e os apps que se conectam a ele.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.