Zum Inhalt

pg_isready

Prüft, ob ein PostgreSQL-Server Verbindungen annimmt, und meldet es als Exit-Code: ideal für Skripte und Monitoring.

pg_isready output

Syntax

pg_isready [-h HOST] [-p PORT] [-d DB] [-U BENUTZER] [-t SEKUNDEN] [-q]

Optionen

Option Beschreibung
-h HOST, -p PORT Server und Port, Standard lokaler Socket und 5432
-d DB, -U BENUTZER Datenbank und Rolle für die Prüfung (nur fürs Log)
-t SEKUNDEN Zeitlimit, Standard 3
-q Keine Ausgabe, nur der Exit-Code

Exit-Codes: 0 nimmt Verbindungen an, 1 lehnt ab (z. B. beim Starten), 2 keine Antwort, 3 kein Versuch (falsche Parameter). pg_isready meldet sich nicht an und braucht deshalb kein Passwort.

Beispiele

Ist der lokale Server bereit:

pg_isready
/var/run/postgresql:5432 - accepting connections

Einen Server über das Netz prüfen:

pg_isready -h 192.0.2.22 -p 5432
192.0.2.22:5432 - accepting connections

Der Server ist gestoppt:

pg_isready; echo $?
/var/run/postgresql:5432 - no response
2

Still, für Skripte:

pg_isready -q && echo ok || echo down
ok

Wann brauche ich das?

  • In Skripten, die warten müssen, bis die Datenbank läuft, z. B. nach einem Neustart
  • Als Health Check in Docker Compose oder einem Monitoring-System
  • Um von einem Anwendungsserver aus schnell zu prüfen, ob die Datenbank erreichbar ist

Auf die Datenbank warten

until pg_isready -q -h db01; do sleep 1; done wartet in einem Deploy-Skript, bis die Datenbank Verbindungen annimmt, und startet erst dann die Migration.

Unterschiede zwischen Distributionen

Debian Ubuntu RHEL Arch
Paket postgresql-client postgresql-client postgresql postgresql-libs

Verwandte Befehle

psql · pg_lsclusters · systemctl · docker compose