PostgreSQL 25001 : impossible d’exécuter à l’intérieur d’un bloc de transaction
Certaines commandes (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) doivent s’exécuter seules, en dehors de BEGIN ... COMMIT.
- SQLSTATE
25001- Nom
active_sql_transaction- Catégorie
- État de transaction invalide
Ce que cela signifie
Quelques commandes PostgreSQL gèrent leurs propres transactions ou ne peuvent pas être annulées, donc elles refusent de s’exécuter à l’intérieur d’un bloc de transaction explicite : VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE et d’autres. Les exécuter l’une après l’autre BEGIN échoue avec 25001 (active_sql_transaction).
Le problème est que beaucoup d’outils et de pilotes ouvrent une transaction pour vous : les frameworks de migration englobent chaque migration dans une transaction, et les clients avec l’autocommit désactivé en démarrent une de façon implicite.
Causes courantes
- Un framework de migration exécute chaque migration dans une transaction.
- Le client ou le pilote a l'autocommit désactivé (par défaut pour psycopg2, JDBC avec
setAutoCommit(false)), de sorte que chaque instruction se trouve dans une transaction. - Un script envoie plusieurs instructions dans une seule chaîne de requête multi-instructions, que PostgreSQL exécute comme une transaction implicite unique.
- Appeler la commande depuis une fonction ou
DOun bloc, qui s'exécute toujours à l'intérieur d'une transaction.
Comment le corriger
-
Exécutez la commande seule avec l'autocommit activé. Dans psql, c'est le comportement par défaut ; il suffit de ne pas la mettre entre
BEGINetCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
Dans votre pilote, activez l'autocommit pour cette instruction (psycopg :
conn.autocommit = True). -
Dans les outils de migration, marquez la migration comme non transactionnelle ; la plupart des frameworks ont une option pour cela.
-
Envoyez chaque commande de ce type comme une requête séparée, pas combinée avec d'autres dans une seule chaîne.
Reproduisez-le en toute sécurité
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
Erreurs liées
25P02la transaction en cours est annulée2D000terminaison de transaction invalide55006objet utilisé
Plus d'erreurs d'état de transaction non valide
25006Transaction SQL en lecture seule25P03délai d'expiration des sessions inactives en transaction
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.
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.