// Referência de erro do PostgreSQL

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
Mensagem de erro
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

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 DO bloco, que sempre é executado dentro de uma transação.

Como corrigir

  1. Execute o comando isoladamente com o autocommit ativado. No psql isso é o padrão; só não o coloque entre BEGIN e COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. No seu driver, ative o autocommit para esta instrução (psycopg: conn.autocommit = True).

  3. Em ferramentas de migração, marque a migração como não transacional; a maioria dos frameworks tem uma opção para isso.

  4. 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.

// 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.