// PostgreSQL-Fehlerreferenz

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
Fehlermeldung
CREATE INDEX CONCURRENTLY cannot run inside a transaction block

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 DO Block, der immer innerhalb einer Transaktion ausgeführt wird.

Wie du es behebst

  1. Führe den Befehl einzeln mit aktiviertem Autocommit aus. In psql ist das die Standardeinstellung; setze ihn nur nicht zwischen BEGIN und COMMIT.

    CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);
  2. Schalt in deinem Treiber für diese Anweisung Autocommit ein (psycopg: conn.autocommit = True).

  3. Markier in Migrationstools die Migration als nicht-transaktional; die meisten Frameworks haben dafür eine Option.

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

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.

// weniger Fehler, schnellere Korrekturen

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.