// Referência de erro do PostgreSQL

PostgreSQL 57P01: encerrando conexão devido ao administrador

O servidor encerrou esta sessão: um administrador chamou pg_terminate_backend, ou o servidor está sendo desligado. Reconecte-se e tente novamente.

SQLSTATE
57P01
Nome
admin_shutdown
Categoria
Intervenção do operador
Mensagem de erro
terminating connection due to administrator command

O que significa

57P01 (admin_shutdown) é enviado como um FATAL erro pouco antes de o servidor fechar a conexão. Isso acontece quando alguém executa pg_terminate_backend() na sessão, quando o servidor é parado com um desligamento rápido, ou quando um serviço gerenciado reinicia ou faz failover da instância.

Qualquer transação que estava em andamento na sessão é revertida. O próximo uso da conexão pelo cliente falha, portanto os pools devem descartá-la e abrir uma nova.

Causas comuns

  • Um administrador ou um script executou pg_terminate_backend(pid), por exemplo, para encerrar sessões ociosas ou limpar bloqueios.
  • O servidor está desligando ou reiniciando (pg_ctl stop -m fast, manutenção, atualização).
  • Um serviço PostgreSQL gerenciado passou por um failover ou aplicou manutenção.

Como corrigir

  1. Reconecte e, se o trabalho estava em uma transação, execute toda a transação novamente.

  2. Configure o pool de conexões para testar as conexões ou tentar uma vez mais em uma conexão nova após esse erro.

  3. Se as sessões estão sendo encerradas inesperadamente, verifique o log do servidor e quaisquer trabalhos que chamem pg_terminate_backend.

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

Erros relacionados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.