// Referencia de errores de PostgreSQL

PostgreSQL 25001: no se puede ejecutar dentro de un bloque de transacción

Algunos comandos (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) deben ejecutarse por sí solos, fuera de BEGIN ... COMMIT.

SQLSTATE
25001
Nombre
active_sql_transaction
Categoría
Estado de transacción no válido
Mensaje de error
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

Qué significa

Un puñado de comandos de PostgreSQL gestionan sus propias transacciones o no se pueden revertir, por lo que se niegan a ejecutarse dentro de un bloque de transacción explícito: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE y otros. Ejecutar uno después de BEGIN falla con 25001 (active_sql_transaction).

El problema es que muchas herramientas y controladores abren una transacción por ti: los frameworks de migración envuelven cada migración en una, y los clientes con autocommit desactivado inician una implícitamente.

Causas comunes

  • Un framework de migraciones ejecuta cada migración dentro de una transacción.
  • El cliente o el controlador tiene autocommit desactivado (por defecto en psycopg2, JDBC con setAutoCommit(false)), así que cada instrucción va dentro de una transacción.
  • Un script envía varias instrucciones como una única cadena de consulta, y PostgreSQL las ejecuta como una sola transacción implícita.
  • Llamar al comando desde una función o DO bloque, que siempre se ejecuta dentro de una transacción.

Cómo solucionarlo

  1. Ejecuta el comando por sí solo con autocommit activado. En psql eso es lo predeterminado; simplemente no lo pongas entre BEGIN y COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. En tu controlador, activa autocommit para esta instrucción (psycopg: conn.autocommit = True).

  3. En las herramientas de migración, marca la migración como no transaccional; la mayoría de los frameworks tienen una opción para ello.

  4. Envía cada uno de esos comandos como una consulta separada, sin combinarlos con otros en una sola cadena.

Reprodúcelo de forma segura

BEGIN;
VACUUM;  -- ERROR: VACUUM cannot run inside a transaction block
ROLLBACK;

Errores relacionados

Más errores de estado de transacción no válido

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.