Menu

Transações no PostgreSQL: BEGIN, COMMIT e ROLLBACK

Como funcionam as transações no PostgreSQL: BEGIN, COMMIT e ROLLBACK, savepoints, o que um erro faz com uma transação aberta e os níveis de isolamento.

Esta página tem editores executáveis. Edite, execute e veja a saída na hora.

Uma transação agrupa comandos para que todos tenham efeito ou nenhum tenha. Comece com BEGIN, torne permanente com COMMIT ou desfaça tudo desde o BEGIN com ROLLBACK. Até você confirmar, as outras sessões não veem suas alterações.

A Alice termina com 70 e o Bob com 80. Se o servidor caísse entre os dois updates, nenhum dos dois ficaria: o dinheiro não sai de uma conta sem chegar à outra.

Desfazer alterações com ROLLBACK

ROLLBACK descarta todas as alterações feitas desde o BEGIN:

O DELETE removeu as três linhas dentro da transação, e o rollback as trouxe de volta: a contagem é 3. No psql, envolva do mesmo jeito um UPDATE ou DELETE manual arriscado. Rode depois de BEGIN, confira o resultado com um SELECT e então escolha COMMIT ou ROLLBACK.

Sem BEGIN, o PostgreSQL roda cada comando na própria transação e confirma quando ele termina (autocommit). Os drivers variam: o psycopg, em Python, inicia uma transação no primeiro comando e espera o conn.commit().

Desfazer parte de uma transação com SAVEPOINT

Um savepoint marca um ponto dentro de uma transação. ROLLBACK TO SAVEPOINT name desfaz só o que foi feito depois dele, e a transação continua:

O log tem "import users" e "import products". A etapa dos pedidos foi desfeita sem perder o primeiro insert. RELEASE SAVEPOINT name descarta um savepoint de que você não precisa mais.

Resolver "current transaction is aborted"

Quando um comando falha dentro de uma transação, o PostgreSQL marca a transação inteira como falha e recusa todos os comandos seguintes até você encerrá-la:

BEGIN;
INSERT INTO accounts VALUES ('alice', 10);   -- duplicate key: error
UPDATE accounts SET balance = 0;
-- ERROR:  current transaction is aborted, commands ignored until end of transaction block
ROLLBACK;

A solução é ROLLBACK. Um COMMIT numa transação abortada não salva nada; o PostgreSQL responde ROLLBACK. Para continuar depois de um erro esperado, crie um savepoint antes do comando arriscado e volte para ele. Drivers e ORMs que oferecem "transações aninhadas" funcionam assim.

Desfazer também as mudanças de tabela

CREATE TABLE, ALTER TABLE, DROP TABLE e a maior parte do DDL são transacionais, então uma migration que falha no meio não deixa nada para trás:

to_regclass retorna NULL: a tabela nunca existiu para mais ninguém. Alguns comandos se recusam a rodar dentro de um bloco de transação, entre eles VACUUM, CREATE DATABASE e CREATE INDEX CONCURRENTLY.

Escolher um nível de isolamento

O nível de isolamento decide quais commits de outras sessões uma transação enxerga. Defina com BEGIN ISOLATION LEVEL ....

NívelO que cada comando vêQuando usar
READ COMMITTED (padrão)Os dados confirmados antes de o comando começarA maioria das aplicações
REPEATABLE READUm snapshot tirado na primeira consulta da transaçãoRelatórios e exportações que precisam ser consistentes
SERIALIZABLEComo REPEATABLE READ, e o PostgreSQL cancela transações cujo resultado poderia ser diferente de rodá-las uma de cada vezRegras de negócio que leem e depois escrevem

READ UNCOMMITTED é aceito mas se comporta como READ COMMITTED: o PostgreSQL nunca mostra dados não confirmados. Com REPEATABLE READ e SERIALIZABLE, espere erros com SQLSTATE 40001 ("could not serialize access") e repita a transação inteira quando receber um.

Travar uma linha que você vai alterar

Para impedir que outra sessão altere uma linha entre a sua leitura e a sua escrita, trave a linha ao ler com FOR UPDATE. Os outros escritores esperam até você confirmar:

BEGIN;
SELECT balance FROM accounts WHERE name = 'alice' FOR UPDATE;
UPDATE accounts SET balance = balance - 30 WHERE name = 'alice';
COMMIT;

Mantenha as transações curtas

Uma transação aberta segura os locks de linha até terminar e impede o VACUUM de remover versões antigas das linhas. Uma sessão deixada "idle in transaction" por um script que travou pode bloquear outros escritores por horas. Configure idle_in_transaction_session_timeout para encerrar essas sessões automaticamente.

Dentro de uma transação, now() retorna o mesmo horário em todos os comandos: o horário em que a transação começou (veja funções de data). O tutorial oficial sobre transações tem mais exemplos.

Perguntas frequentes

O PostgreSQL usa autocommit?

Sim. Um comando enviado fora de BEGIN roda na própria transação e é confirmado quando termina. Alguns drivers invertem isso: o psycopg, em Python, abre uma transação para você e espera o commit(), a menos que você ative o autocommit.

Qual é o nível de isolamento padrão do PostgreSQL?

READ COMMITTED. Cada comando vê os dados confirmados antes de ele começar. Use BEGIN ISOLATION LEVEL REPEATABLE READ ou SERIALIZABLE quando uma transação precisa ver um único snapshot consistente.

Dá para fazer rollback de CREATE TABLE ou ALTER TABLE no PostgreSQL?

Dá. Quase todo DDL no PostgreSQL é transacional, então um CREATE, ALTER ou DROP dentro de uma transação some com o ROLLBACK. Alguns comandos, como CREATE DATABASE, VACUUM e CREATE INDEX CONCURRENTLY, não podem rodar dentro de um bloco de transação.

Qual a diferença entre COMMIT e END no PostgreSQL?

Nenhuma. END é uma extensão do PostgreSQL que faz o mesmo que COMMIT, e START TRANSACTION é a grafia padrão de BEGIN.

Ilustração das linguagens de programação do Coddy

Aprenda a programar com o Coddy

Começar