// Référence des erreurs PostgreSQL

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
Message d'erreur
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

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 DO un bloc, qui s'exécute toujours à l'intérieur d'une transaction.

Comment le corriger

  1. 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 BEGIN et COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. Dans votre pilote, activez l'autocommit pour cette instruction (psycopg : conn.autocommit = True).

  3. Dans les outils de migration, marquez la migration comme non transactionnelle ; la plupart des frameworks ont une option pour cela.

  4. 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

Plus d'erreurs d'état de transaction non valide

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.