// Referencia de errores de PostgreSQL

PostgreSQL 53200: sin memoria

Un proceso del servidor no pudo asignar memoria para la consulta. Suele deberse a un ordenamiento o hash enorme, a un resultado muy grande construido en memoria o a demasiadas conexiones ocupadas.

SQLSTATE
53200
Nombre
out_of_memory
Categoría
Recursos insuficientes
Mensaje de error
out of memory
DETAIL:  Failed on request of size 1048576 in memory context "ExecutorState".

Qué significa

PostgreSQL asigna memoria en contextos. Cuando el sistema operativo rechaza una asignación, la instrucción falla con 53200 y el DETAIL la línea indica el tamaño de la solicitud y el contexto de memoria. El registro del servidor recibe un volcado de los tamaños del contexto de memoria que muestra dónde se fue la memoria.

En Linux con sobrecompromiso de memoria, el OOM killer del kernel puede matar directamente un proceso de PostgreSQL; el servidor luego reinicia todas las sesiones, y los clientes ven cómo se cortan sus conexiones.

Causas comunes

  • work_mem establecido en un valor alto y multiplicado por muchos nodos de ordenamiento y hash, en muchas sesiones a la vez.
  • Una consulta que devuelve o agrega una cantidad enorme de datos en un solo valor, como array_agg o string_agg sobre millones de filas.
  • Demasiadas conexiones para la memoria de la máquina.
  • Una fuga de memoria en una extensión, o muy grande maintenance_work_mem durante la construcción de índices.

Cómo solucionarlo

  1. Lee el volcado del contexto de memoria en el registro del servidor para ver qué contexto creció.

  2. Inferior work_mem globalmente, y aumenta solo para la sesión que lo necesita.

    ALTER SYSTEM SET work_mem = '16MB';
    SELECT pg_reload_conf();
    -- for one heavy report:
    SET work_mem = '256MB';
  3. Revisa el plan en busca de uniones hash y ordenaciones con muchas más filas de las esperadas, y corrige las estimaciones o añade un índice.

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. Limita la concurrencia con un pool de conexiones y, en Linux, configura vm.overcommit_memory = 2 para que las asignaciones fallen limpiamente en lugar de activar el OOM killer.

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.