// Referência de erro do PostgreSQL

PostgreSQL 2D000: término inválido de transação

COMMIT ou ROLLBACK executado dentro de um procedimento ou bloco DO que não pode controlar transações, por exemplo, um bloco chamado dentro de uma transação explícita ou a partir de uma função.

SQLSTATE
2D000
Nome
invalid_transaction_termination
Categoria
Encerramento de transação inválido
Mensagem de erro
invalid transaction termination

O que significa

Desde o PostgreSQL 11, procedimentos (CALL) e DO os blocos podem ser executados COMMIT e ROLLBACK. Isso só funciona quando eles são chamados no nível superior, não dentro de uma transação que o chamador abriu. Se um procedimento for chamado depois BEGIN, de uma função, de um trigger ou por um caminho que o envolva em uma transação, seu COMMIT falha com 2D000.

Funções nunca podem fazer commit nem rollback; o trabalho delas é sempre parte da transação do chamador.

Causas comuns

  • Chamar o procedimento dentro de BEGIN ... COMMIT, ou de um cliente com o autocommit desligado.
  • Chamá-lo a partir de uma função, de um gatilho ou de um SELECT.
  • A COMMIT dentro de um corpo de função em vez de um procedimento.
  • A COMMIT dentro de um bloco que tem um EXCEPTION cláusula, que é executada como uma subtransação.

Como corrigir

  1. Chame o procedimento isoladamente, com autocommit ativado.

    CALL archive_old_orders();
  2. Se você precisar de controle de transação, transforme-o em um procedimento, não em uma função, e mantenha COMMIT fora de blocos com manipuladores de exceção.

    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;
    $$;

Erros relacionados

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.