// PostgreSQL-Fehlerreferenz

PostgreSQL 25006: schreibgeschützte SQL-Transaktion

Es wurde versucht, in einer schreibgeschützten Transaktion zu schreiben: auf einem Hot-Standby-Replikat, mit default_transaction_read_only aktiviert oder nach SET TRANSACTION READ ONLY.

SQLSTATE
25006
Name
read_only_sql_transaction
Kategorie
Ungültiger Transaktionszustand
Fehlermeldung
cannot execute INSERT in a read-only transaction

Was es bedeutet

PostgreSQL verweigert INSERT, UPDATE, DELETE, DDL und andere Schreibvorgänge, wenn die Transaktion schreibgeschützt ist. Das passiert, wenn du mit einem Streaming-Replikations-Standby verbunden bist (alle Transaktionen dort sind schreibgeschützt), wenn default_transaction_read_only ist für den Server, die Datenbank oder Rolle aktiviert, oder wenn die Transaktion gestartet wurde READ ONLY.

Die Nachricht nennt den Befehl, der abgelehnt wurde.

Häufige Ursachen

  • Die Verbindung ging zu einem Lesereplikat, zum Beispiel über einen Load Balancer oder einen DNS-Namen, der nach einem Failover auf einen Standby zeigt.
  • default_transaction_read_only = on auf der Datenbank oder Rolle gesetzt, manchmal absichtlich für Reporting-Benutzer.
  • BEGIN READ ONLY oder SET TRANSACTION READ ONLY früher in der Transaktion.
  • Eine verwaltete Datenbank ist schreibgeschützt geworden, weil ihr Speicher voll war.

Wie du es behebst

  1. Prüfe, ob du auf einem Standby-System bist und ob der Nur-Lese-Modus gesetzt ist.

    SELECT pg_is_in_recovery();
    SHOW default_transaction_read_only;
    SHOW transaction_read_only;
  2. Sende Schreibvorgänge an das Primary. Mit libpq 14 und neuer, target_session_attrs=read-write In der Verbindungszeichenfolge wird der beschreibbare Host aus einer Liste ausgewählt.

  3. Wenn die Rolle oder Datenbank versehentlich auf schreibgeschützt gesetzt wurde, dreh das zurück.

    ALTER ROLE app SET default_transaction_read_only = off;
    ALTER DATABASE shop SET default_transaction_read_only = off;

Sicher reproduzieren

BEGIN READ ONLY;
CREATE TEMP TABLE t (id int);  -- ERROR: cannot execute CREATE TABLE in a read-only transaction
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.