// Référence des erreurs PostgreSQL

PostgreSQL 2D000 : terminaison de transaction invalide

COMMIT ou ROLLBACK exécuté à l'intérieur d'une procédure ou d'un bloc DO qui ne peut pas contrôler les transactions, par exemple une procédure appelée dans une transaction explicite ou depuis une fonction.

SQLSTATE
2D000
Nom
invalid_transaction_termination
Catégorie
Fin de transaction invalide
Message d'erreur
invalid transaction termination

Ce que cela signifie

Depuis PostgreSQL 11, les procédures (CALL) et DO les blocs peuvent s'exécuter COMMIT et ROLLBACK. Cela ne fonctionne que lorsqu'ils sont appelés au niveau supérieur, pas à l'intérieur d'une transaction ouverte par l'appelant. Si une procédure est appelée après BEGIN, depuis une fonction, depuis un déclencheur, ou via un chemin qui l'enveloppe dans une transaction, son COMMIT échoue avec 2D000.

Les fonctions ne peuvent jamais valider ni annuler ; leur travail fait toujours partie de la transaction de l'appelant.

Causes courantes

  • Appeler la procédure à l'intérieur de BEGIN ... COMMIT, ou depuis un client avec l'autocommit désactivé.
  • L'appeler depuis une fonction, un déclencheur ou un SELECT.
  • A COMMIT à l'intérieur du corps d'une fonction plutôt que dans une procédure.
  • A COMMIT à l'intérieur d'un bloc qui a un EXCEPTION clause, qui s'exécute comme une sous-transaction.

Comment le corriger

  1. Appelez la procédure seule, avec l'autocommit activé.

    CALL archive_old_orders();
  2. Si vous avez besoin de contrôle de transaction, faites-en une procédure, pas une fonction, et gardez COMMIT à l'extérieur des blocs avec gestionnaires d'exceptions.

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

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.