// Référence des erreurs PostgreSQL

PostgreSQL 3B001 : spécification de point de sauvegarde invalide

ROLLBACK TO SAVEPOINT ou RELEASE désigne un point de sauvegarde qui n'existe pas dans la transaction en cours, souvent parce qu'il a déjà été libéré ou n'a jamais été défini.

SQLSTATE
3B001
Nom
invalid_savepoint_specification
Catégorie
Exception de point de sauvegarde
Message d'erreur
savepoint "before_update" does not exist

Ce que cela signifie

Les points de sauvegarde marquent un endroit dans une transaction vers lequel vous pouvez revenir. 3B001 signifie que le nom dans ROLLBACK TO SAVEPOINT ou RELEASE SAVEPOINT ne correspond pas à un point de sauvegarde actif : il n'a jamais été créé, il a été libéré, ou un retour en arrière vers un point de sauvegarde antérieur l'a supprimé.

Les points de sauvegarde n'existent que dans un bloc de transaction. En dehors, la commande échoue avec une erreur différente (can only be used in transaction blocks, 25P01).

Causes courantes

  • Une faute de frappe dans le nom du point de sauvegarde.
  • RELEASE SAVEPOINT a déjà été exécuté, ce qui supprime ce point de sauvegarde et tous ceux créés après.
  • ROLLBACK TO un point de sauvegarde antérieur, ce qui détruit les points de sauvegarde créés après.
  • L'autocommit est activé, donc chaque instruction est sa propre transaction et le point de sauvegarde a disparu à la fin de l'instruction.

Comment le corriger

  1. Exécutez toute la séquence dans une seule transaction, avec des noms cohérents.

    BEGIN;
    SAVEPOINT before_update;
    UPDATE accounts SET balance = balance - 100 WHERE id = 1;
    ROLLBACK TO SAVEPOINT before_update;
    COMMIT;
  2. Recréez un point de sauvegarde après y avoir fait un rollback si vous devez y revenir une seconde fois ; ROLLBACK TO garde le point de sauvegarde lui-même mais RELEASE supprime celui-ci.

Reproduisez-le en toute sécurité

BEGIN;
ROLLBACK TO SAVEPOINT nope;  -- ERROR: savepoint "nope" does not exist
ROLLBACK;

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.