07 November 2026

Wie beendet man problematische PostgreSQL-Sessions sicher?

Hand eines Datenbankadministrators über einem Notfall-Absperrventil an einem Server-Rack mit bernsteinfarbener Warnleuchte.
KI-generiertes Bild

Hängende Abfragen, blockierte Locks oder überlastete Verbindungspools: In einer produktiven PostgreSQL®-Umgebung kann es jederzeit vorkommen, dass einzelne Sessions problematisch werden und andere Prozesse blockieren. Wer in solchen Situationen schnell und gezielt handeln kann, verhindert Folgeschäden und hält den Datenbankbetrieb stabil.

Dieser Leitfaden zeigt Schritt für Schritt, wie Sie problematische PostgreSQL-Sessions identifizieren, gezielt abbrechen und bei Bedarf hart trennen. Sie lernen außerdem, wie Sie mehrere Verbindungen gleichzeitig beenden und welche Sonderfälle dabei zu beachten sind.

Problematische Sessions in PostgreSQL identifizieren

Bevor Sie PostgreSQL-Prozesse beenden, müssen Sie wissen, welche Sessions tatsächlich problematisch sind. PostgreSQL stellt dafür die Systemsicht pg_stat_activity zur Verfügung, die alle aktiven Verbindungen mit ihren wichtigsten Metadaten auflistet.

Führen Sie folgende Abfrage als Superuser aus, um einen Überblick über alle laufenden Sessions zu erhalten:

  1. Verbinden Sie sich mit Ihrer Datenbank als Superuser, zum Beispiel als postgres.
  2. Führen Sie die Abfrage SELECT pid, usename, application_name, state, wait_event_type, wait_event, query_start, query FROM pg_stat_activity WHERE state != 'idle'; aus.
  3. Prüfen Sie die Spalte state: Der Wert active zeigt laufende Abfragen, idle in transaction deutet auf eine offene Transaktion ohne aktive Abfrage hin.
  4. Achten Sie auf die Spalte wait_event_type: Der Wert Lock signalisiert, dass eine Session auf eine Sperre wartet und möglicherweise andere blockiert.
  5. Notieren Sie die pid (Prozess-ID) der auffälligen Sessions, da Sie diese für die nächsten Schritte benötigen.

Nach dieser Abfrage haben Sie eine klare Liste der Sessions, die ein Eingreifen erfordern. Sessions mit dem Status idle in transaction und einem hohen Wert in query_start sind häufig die Hauptverursacher von Blockierungen. Mit dieser Information können Sie gezielt vorgehen, anstatt blind Verbindungen zu trennen.

Sessions mit pg_cancel_backend gezielt abbrechen

Der sanfte Weg, eine PostgreSQL-Session zu beenden, führt über die Funktion pg_cancel_backend(). Diese Funktion sendet ein SIGINT-Signal an den zugehörigen Prozess, was dazu führt, dass die aktuell laufende Abfrage abgebrochen wird. Die Verbindung selbst bleibt dabei bestehen, sodass der Client die Möglichkeit hat, erneut zu verbinden oder eine neue Abfrage zu starten.

Verwenden Sie diesen Ansatz immer dann, wenn Sie eine hängende Abfrage beenden möchten, ohne die Sitzung des Nutzers vollständig zu unterbrechen:

  1. Notieren Sie die pid der problematischen Session aus pg_stat_activity.
  2. Führen Sie SELECT pg_cancel_backend(pid); aus, wobei Sie pid durch die tatsächliche Prozess-ID ersetzen.
  3. Die Funktion gibt true zurück, wenn das Signal erfolgreich gesendet wurde, und false, wenn die Session nicht mehr existiert.

Prüfen Sie anschließend mit einer erneuten Abfrage auf pg_stat_activity, ob die Session weiterhin den Status active hat. In den meisten Fällen reagiert PostgreSQL innerhalb weniger Sekunden. Reagiert die Session nicht, weil sie beispielsweise auf ein externes Ereignis oder einen Lock wartet, müssen Sie zur härteren Methode wechseln.

Verbindungen mit pg_terminate_backend hart trennen

Wenn pg_cancel_backend() nicht ausreicht, kommt pg_terminate_backend() zum Einsatz. Diese Funktion sendet ein SIGTERM-Signal und beendet nicht nur die Abfrage, sondern die gesamte Datenbankverbindung. Laufende Transaktionen werden dabei automatisch zurückgerollt. Dies ist die zuverlässigste Methode, um hängende PostgreSQL-Verbindungen zu schließen.

Gehen Sie dabei wie folgt vor:

  1. Identifizieren Sie die pid der Session, die Sie beenden möchten.
  2. Führen Sie SELECT pg_terminate_backend(pid); aus.
  3. Auch hier gibt die Funktion true bei Erfolg zurück.
  4. Kontrollieren Sie mit SELECT pid FROM pg_stat_activity WHERE pid = [Ihre_PID];, ob die Session tatsächlich verschwunden ist.

Beachten Sie, dass pg_terminate_backend() in der Regel nur von Superusern oder Mitgliedern der Rolle pg_signal_backend ausgeführt werden darf. Ein normaler Datenbanknutzer kann nur seine eigenen Prozesse beenden. Nach der Trennung erhält der Client typischerweise eine Fehlermeldung wie FATAL: terminating connection due to administrator command. Das ist das erwartete Verhalten und bestätigt, dass der Befehl korrekt ausgeführt wurde.

Mehrere Sessions gleichzeitig beenden

Manchmal ist es notwendig, nicht nur eine einzelne, sondern mehrere problematische Sessions auf einmal zu beenden, etwa wenn eine Anwendung zu viele Verbindungen geöffnet hat oder Sie eine Datenbank für Wartungsarbeiten freimachen möchten. PostgreSQL ermöglicht dies durch die Kombination von pg_terminate_backend() mit einer gefilterten Abfrage auf pg_stat_activity.

Für das gleichzeitige Beenden mehrerer PostgreSQL-Datenbankverbindungen stehen Ihnen folgende Abfragemuster zur Verfügung:

  • Alle Sessions einer bestimmten Datenbank beenden: SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'meine_datenbank' AND pid != pg_backend_pid();
  • Alle Sessions eines bestimmten Nutzers beenden: SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE usename = 'app_user' AND pid != pg_backend_pid();
  • Alle idle-in-transaction-Sessions älter als 10 Minuten beenden: SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE state = 'idle in transaction' AND query_start < NOW() - INTERVAL '10 minutes';

Der Ausdruck pid != pg_backend_pid() ist dabei entscheidend: Er stellt sicher, dass Ihre eigene aktuelle Verbindung nicht beendet wird. Testen Sie solche Abfragen zunächst mit einem SELECT ohne die pg_terminate_backend()-Funktion, um zu sehen, welche Sessions betroffen wären, bevor Sie die Aktion tatsächlich ausführen. Wer PostgreSQL-Datenbankverbindungen regelmäßig verwaltet, profitiert von einem strukturierten Monitoring, das solche Situationen frühzeitig erkennt.

Häufige Fehler und Sonderfälle beim Beenden von Sessions

Auch mit den richtigen Befehlen gibt es Situationen, in denen das Beenden von Sessions nicht wie erwartet funktioniert. Kennen Sie diese Sonderfälle, sparen Sie sich aufwendige Fehlersuche.

Die Session reagiert nicht auf pg_terminate_backend

In seltenen Fällen, etwa wenn ein Prozess in einem unkündbaren Kernel-Systemaufruf steckt, reagiert PostgreSQL nicht sofort auf SIGTERM. In diesem Fall können Sie auf Betriebssystemebene eingreifen:

  1. Ermitteln Sie die pid aus pg_stat_activity.
  2. Führen Sie als Betriebssystem-Superuser kill -9 [pid] aus.
  3. PostgreSQL erkennt den abgestürzten Prozess und führt automatisch eine Recovery durch.

Setzen Sie kill -9 nur als letztes Mittel ein, da dies keine saubere Transaktion mehr ermöglicht und PostgreSQL in den Recovery-Modus versetzt.

Berechtigungsfehler beim Beenden fremder Sessions

Wenn Sie die Fehlermeldung ERROR: must be a superuser to terminate superuser process erhalten, fehlen Ihrem Nutzer die notwendigen Rechte. Vergeben Sie in diesem Fall die Rolle pg_signal_backend mit GRANT pg_signal_backend TO mein_nutzer;. Beachten Sie jedoch, dass diese Rolle in PostgreSQL® 14 und neuer verfügbar ist und auch damit keine Superuser-Prozesse beendet werden können.

Sessions kehren sofort zurück

Wenn nach dem Beenden einer Session sofort eine neue mit ähnlichen Eigenschaften erscheint, liegt das Problem in der Anwendung selbst: Ein Connection-Pooler oder eine Applikation öffnet automatisch neue Verbindungen. In diesem Fall hilft es nicht, Einzelsessions zu beenden. Prüfen Sie stattdessen die Konfiguration Ihres Connection-Poolers oder schränken Sie die maximalen Verbindungen für den betreffenden Nutzer mit ALTER ROLE app_user CONNECTION LIMIT 5; ein. Für eine nachhaltige Lösung sollten Sie außerdem die PostgreSQL-LTS-Umgebung und deren Konfigurationsoptionen in Betracht ziehen.

Wie credativ® beim Verwalten von PostgreSQL-Sessions hilft

Das gezielte Beenden von PostgreSQL-Sessions ist in akuten Situationen unverzichtbar. Doch nachhaltige Stabilität entsteht durch proaktives Monitoring, durchdachte Konfiguration und erfahrene Expertise im Hintergrund. Genau das bieten wir mit unserem PostgreSQL® Kompetenz-Center.

Konkret unterstützen wir Sie bei folgenden Aufgaben rund um das Thema PostgreSQL-Datenbankverbindungen verwalten:

  • Proaktives Session- und Lock-Monitoring: Wir richten maßgeschneiderte Monitoring-Umgebungen ein, die hängende Verbindungen und Blocking-Situationen frühzeitig erkennen und alarmieren, bevor sie zu Ausfällen führen.
  • Konfigurationsoptimierung: Wir analysieren und optimieren Parameter wie idle_in_transaction_session_timeout und statement_timeout, die problematische Sessions automatisch beenden, ohne manuelles Eingreifen.
  • Connection-Pool-Beratung: Wir helfen bei der Auswahl und Konfiguration geeigneter Connection-Pooler wie PgBouncer, um Verbindungsüberlastungen strukturell zu vermeiden.
  • 24/7 Support: Bei akuten Datenbankproblemen stehen Ihnen unsere PostgreSQL-Spezialisten rund um die Uhr direkt zur Verfügung, ohne Callcenter und ohne Wartezeit auf Weiterleitungen.
  • Schulungen und Workshops: Wir vermitteln Ihrem Team das Wissen, um PostgreSQL-Prozesse sicher zu beenden und Datenbankverbindungen eigenständig zu verwalten.

Möchten Sie Ihre PostgreSQL®-Umgebung langfristig stabil und sicher betreiben? Kontaktieren Sie uns und erfahren Sie, wie wir Sie dabei unterstützen können.

PostgreSQL® ist eine Marke der PostgreSQL Community Association of California. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine geschäftliche Verbindung zu den genannten Markeninhabern.

Ähnliche Artikel

Kategorien: credativ® Inside

über den Autor

Peter Dreuw

Head of Sales & Marketing

zur Person

Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.

Beiträge ansehen


Beitrag teilen: