// PostgreSQL-Fehlerreferenz

PostgreSQL 57P01: Verbindung wird auf Anweisung des Administrators beendet

Der Server hat diese Sitzung beendet: Ein Administrator hat pg_terminate_backend aufgerufen, oder der Server fährt herunter. Verbinde dich neu und versuche es noch einmal.

SQLSTATE
57P01
Name
admin_shutdown
Kategorie
Eingreifen des Bedieners
Fehlermeldung
terminating connection due to administrator command

Was es bedeutet

57P01 (admin_shutdown) wird als ein FATAL Fehler gesendet, kurz bevor der Server die Verbindung schließt. Dies passiert, wenn jemand pg_terminate_backend() in der Sitzung ausführt, wenn der Server mit einem schnellen Herunterfahren gestoppt wird oder wenn ein Managed-Service die Instanz neu startet oder ein Failover durchführt.

Jede Transaktion, die in der Sitzung im Gange war, wird zurückgesetzt. Die nächste Nutzung der Verbindung durch den Client schlägt fehl, daher sollten Pools sie verwerfen und eine neue öffnen.

Häufige Ursachen

  • Ein Administrator oder ein Skript verwendete pg_terminate_backend(pid), zum Beispiel um inaktive Sitzungen zu beenden oder Sperren zu lösen.
  • Der Server wird heruntergefahren oder neu gestartet (pg_ctl stop -m fast, Wartung, Upgrade).
  • Ein verwalteter PostgreSQL-Dienst hat einen Failover durchgeführt oder Wartung angewendet.

Wie du es behebst

  1. Stelle die Verbindung wieder her und führe, falls die Arbeit in einer Transaktion steckte, die ganze Transaktion erneut aus.

  2. Konfiguriere den Verbindungspool so, dass Verbindungen getestet oder der Vorgang nach diesem Fehler einmal auf einer neuen Verbindung wiederholt wird.

  3. Wenn Sitzungen unerwartet beendet werden, prüfe das Serverprotokoll und alle Jobs mit einem Aufruf von pg_terminate_backend.

    SELECT pid, usename, query FROM pg_stat_activity WHERE query ILIKE '%pg_terminate_backend%';

Zugehörige Fehler

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.