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
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
DObloque, que siempre se ejecuta dentro de una transacción.
Cómo solucionarlo
-
Ejecuta el comando por sí solo con autocommit activado. En psql eso es lo predeterminado; simplemente no lo pongas entre
BEGINyCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
En tu controlador, activa autocommit para esta instrucción (psycopg:
conn.autocommit = True). -
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.
-
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
25P02la transacción actual está abortada2D000terminación de transacción no válida55006objeto en uso
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.
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.