PostgreSQL 25001: kann nicht innerhalb eines Transaktionsblocks ausgeführt werden
Einige Befehle (VACUUM, CREATE DATABASE, CREATE INDEX CONCURRENTLY, ALTER SYSTEM) müssen eigenständig ausgeführt werden, außerhalb von BEGIN ... COMMIT.
- SQLSTATE
25001- Name
active_sql_transaction- Kategorie
- Ungültiger Transaktionszustand
Was es bedeutet
Eine Handvoll PostgreSQL-Befehle verwaltet ihre eigenen Transaktionen oder kann nicht zurückgesetzt werden, daher verweigern sie die Ausführung innerhalb eines expliziten Transaktionsblocks: VACUUM, CREATE DATABASE, DROP DATABASE, CREATE INDEX CONCURRENTLY, REINDEX ... CONCURRENTLY, ALTER SYSTEM, CREATE TABLESPACE und andere. Der Versuch, sie nacheinander auszuführen, BEGIN schlägt mit 25001 fehl (active_sql_transaction).
Der Haken daran: Viele Tools und Treiber öffnen eine Transaktion für dich. Migrations-Frameworks wickeln jede Migration in eine, und Clients mit ausgeschaltetem Autocommit starten implizit eine.
Häufige Ursachen
- Ein Migrations-Framework führt jede Migration innerhalb einer Transaktion aus.
- Der Client oder Treiber hat Autocommit ausgeschaltet (Standard von psycopg2, JDBC mit
setAutoCommit(false)), sodass jede Anweisung innerhalb einer Transaktion ausgeführt wird. - Ein Skript schickt mehrere Anweisungen als eine einzige Multi-Statement-Abfragezeichenfolge, die PostgreSQL als eine einzelne implizite Transaktion ausführt.
- Aufrufen des Befehls aus einer Funktion oder
DOBlock, der immer innerhalb einer Transaktion ausgeführt wird.
Wie du es behebst
-
Führe den Befehl einzeln mit aktiviertem Autocommit aus. In psql ist das die Standardeinstellung; setze ihn nur nicht zwischen
BEGINundCOMMIT.CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
-
Schalt in deinem Treiber für diese Anweisung Autocommit ein (psycopg:
conn.autocommit = True). -
Markier in Migrationstools die Migration als nicht-transaktional; die meisten Frameworks haben dafür eine Option.
-
Senden Sie jeden solchen Befehl als separate Abfrage, nicht kombiniert mit anderen in einem String.
Sicher reproduzieren
BEGIN; VACUUM; -- ERROR: VACUUM cannot run inside a transaction block ROLLBACK;
Zugehörige Fehler
25P02Die aktuelle Transaktion wurde abgebrochen2D000ungültiger Abschluss der Transaktion55006Objekt wird gerade verwendet
Weitere Fehler bei ungültigem Transaktionszustand
Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit PostgreSQL in SQLly
Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.