// Referência de erro do PostgreSQL

PostgreSQL 53200: sem memória

Um processo do servidor não conseguiu alocar memória para a consulta. Geralmente uma ordenação ou hash enorme, um resultado muito grande construído na memória ou conexões ocupadas demais.

SQLSTATE
53200
Nome
out_of_memory
Categoria
Recursos insuficientes
Mensagem de erro
out of memory
DETAIL:  Failed on request of size 1048576 in memory context "ExecutorState".

O que significa

O PostgreSQL aloca memória em contextos. Quando o sistema operacional recusa uma alocação, a instrução falha com 53200 e o DETAIL a linha nomeia o tamanho da requisição e o contexto de memória. O log do servidor obtém um despejo dos tamanhos de contexto de memória que mostra para onde a memória foi.

No Linux, com overcommit de memória, o OOM killer do kernel pode, em vez disso, matar um processo do PostgreSQL sumariamente; o servidor então reinicia todas as sessões, e os clientes veem as conexões caírem.

Causas comuns

  • work_mem definido com valor alto e multiplicado por muitos nós de ordenação e hash, em muitas sessões ao mesmo tempo.
  • Uma consulta que retorna ou agrega uma quantidade enorme de dados em um único valor, como array_agg ou string_agg sobre milhões de linhas.
  • Conexões demais para a memória da máquina.
  • Um vazamento de memória em uma extensão, ou muito grande maintenance_work_mem durante a construção de índices.

Como corrigir

  1. Leia o despejo de contexto de memória no log do servidor para ver qual contexto cresceu.

  2. Reduzir work_mem globalmente, e aumentá-lo apenas para a sessão que precisa disso.

    ALTER SYSTEM SET work_mem = '16MB';
    SELECT pg_reload_conf();
    -- for one heavy report:
    SET work_mem = '256MB';
  3. Procure no plano junções hash e ordenações sobre muito mais linhas do que o esperado, e corrija as estimativas ou adicione um índice.

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. Limite a concorrência com um pool de conexões e, no Linux, configure vm.overcommit_memory = 2 para que as alocações falhem de forma limpa em vez de acionar o OOM killer.

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.