// Referencia de errores de PostgreSQL

PostgreSQL 2D000: terminación de transacción no válida

COMMIT o ROLLBACK ejecutado dentro de un procedimiento o bloque DO que no puede controlar transacciones, por ejemplo, uno llamado dentro de una transacción explícita o desde una función.

SQLSTATE
2D000
Nombre
invalid_transaction_termination
Categoría
Terminación de transacción no válida
Mensaje de error
invalid transaction termination

Qué significa

Desde PostgreSQL 11, procedimientos (CALL) y DO los bloques pueden ejecutarse COMMIT y ROLLBACK. Eso solo funciona cuando se llaman en el nivel superior, no dentro de una transacción que haya abierto el llamador. Si se llama a un procedimiento después de BEGIN, desde una función, desde un trigger, o a través de una ruta que lo envuelve en una transacción, su COMMIT falla con 2D000.

Las funciones nunca pueden hacer commit o rollback; su trabajo siempre forma parte de la transacción del llamador.

Causas comunes

  • Llamar al procedimiento dentro de BEGIN ... COMMIT, o desde un cliente con autocommit desactivado.
  • Llamarlo desde una función, un trigger o un SELECT.
  • A COMMIT dentro del cuerpo de una función y no de un procedimiento.
  • A COMMIT dentro de un bloque que tiene un EXCEPTION cláusula, que se ejecuta como una subtransacción.

Cómo solucionarlo

  1. Llama al procedimiento por sí solo, con autocommit activado.

    CALL archive_old_orders();
  2. Si necesitas control de transacciones, conviértelo en un procedimiento, no en una función, y mantén COMMIT fuera de bloques con manejadores de excepciones.

    CREATE PROCEDURE archive_old_orders()
    LANGUAGE plpgsql AS $$
    BEGIN
        LOOP
            DELETE FROM orders WHERE id IN (
                SELECT id FROM orders WHERE created_at < now() - interval '2 years' LIMIT 1000);
            EXIT WHEN NOT FOUND;
            COMMIT;
        END LOOP;
    END;
    $$;

Errores relacionados

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.