// Referencia de errores de PostgreSQL

PostgreSQL 57P01: conexión terminada por el administrador

El servidor terminó esta sesión: un administrador llamó a pg_terminate_backend, o el servidor se está apagando. Vuelve a conectarte y reinténtalo.

SQLSTATE
57P01
Nombre
admin_shutdown
Categoría
Intervención del operador
Mensaje de error
terminating connection due to administrator command

Qué significa

57P01 (admin_shutdown) se envía como un FATAL error justo antes de que el servidor cierre la conexión. Ocurre cuando alguien ejecuta pg_terminate_backend() en la sesión, cuando el servidor se detiene con un apagado rápido, o cuando un servicio gestionado reinicia o hace failover de la instancia.

Cualquier transacción abierta en la sesión se revierte. El siguiente uso que el cliente haga de la conexión falla, así que los pools deberían descartarla y abrir una nueva.

Causas comunes

  • Un administrador o un script ejecutó pg_terminate_backend(pid), por ejemplo, para cerrar sesiones inactivas o liberar bloqueos.
  • El servidor se está apagando o reiniciando (pg_ctl stop -m fast, mantenimiento, actualización).
  • Un servicio gestionado de PostgreSQL hizo un failover o aplicó mantenimiento.

Cómo solucionarlo

  1. Vuelve a conectarte y, si el trabajo estaba en una transacción, ejecuta de nuevo toda la transacción.

  2. Configura el grupo de conexiones para probar conexiones o reintentar una vez en una nueva conexión después de este error.

  3. Si las sesiones se están terminando inesperadamente, revisa el registro del servidor y cualquier trabajo que llame a pg_terminate_backend.

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

Errores relacionados

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.