57P01: admin_shutdown

Que signifie cette erreur ?

Votre connexion active a été terminée suite à une commande d'administrateur. Le client reçoit cette erreur lorsque le serveur s'arrête ou que la session est terminée manuellement ('terminating connection due to administrator command').

Cause

Un DBA a tué la session avec pg_terminate_backend() ; le serveur est arrêté en mode fast/immediate (le smart shutdown ne tue pas les sessions, il attend leur fin) ; ou les connexions existantes ont été coupées pour un changement de configuration/une maintenance planifiée. Dans certains scénarios de failover, l'ancien primaire coupe aussi les connexions de cette façon.

Comment la corriger

Ce n'est généralement pas une erreur permanente ; l'application doit se reconnecter (relance). Si c'est inattendu, recherchez la raison de l'arrêt/de la terminaison dans le journal du serveur. Pour les maintenances planifiées, implémentez la reconnexion automatique et les contrôles de santé du pool de connexions dans l'application. Le journal du serveur n'indique pas qui a terminé une session ; pour tracer les appels à pg_terminate_backend, conservez une piste d'audit avec log_statement (ou pgaudit).