PostgreSQL 25001: não pode ser executado dentro de um bloco de transação
Alguns comandos (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) devem ser executados isoladamente, fora de BEGIN ... COMMIT.
- SQLSTATE
25001- Nome
active_sql_transaction- Categoria
- Estado de transação inválido
O que significa
Alguns comandos do PostgreSQL gerenciam suas próprias transações ou não podem ser revertidos, então se recusam a ser executados dentro de um bloco de transação explícito: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE e outros. Executar um após o outro BEGIN falha com 25001 (active_sql_transaction).
O problema é que muitas ferramentas e drivers abrem uma transação para você: frameworks de migração envolvem cada migração em uma transação, e clientes com autocommit desativado iniciam uma de forma implícita.
Causas comuns
- Um framework de migração executa cada migração dentro de uma transação.
- O cliente ou driver tem autocommit desligado (padrão do psycopg2, JDBC com
setAutoCommit(false)), então cada instrução está dentro de uma transação. - Um script envia várias instruções como uma única string de consulta multi-instrução, que o PostgreSQL executa como uma única transação implícita.
- Chamar o comando a partir de uma função ou
DObloco, que sempre é executado dentro de uma transação.
Como corrigir
-
Execute o comando isoladamente com o autocommit ativado. No psql isso é o padrão; só não o coloque entre
BEGINeCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
No seu driver, ative o autocommit para esta instrução (psycopg:
conn.autocommit = True). -
Em ferramentas de migração, marque a migração como não transacional; a maioria dos frameworks tem uma opção para isso.
-
Envie cada um desses comandos como uma consulta separada, não combinados com outros em uma única string.
Reproduza com segurança
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
Erros relacionados
Mais erros de estado de transação inválido
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.
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.