// справочник ошибок PostgreSQL

PostgreSQL 53200: недостаточно памяти

Процесс на сервере не смог выделить память для запроса. Обычно это связано с огромной сортировкой или хэшированием, очень большим результатом, сформированным в памяти, или слишком большим числом занятых соединений.

SQLSTATE
53200
Имя
out_of_memory
Категория
Недостаточно ресурсов
Сообщение об ошибке
out of memory
DETAIL:  Failed on request of size 1048576 in memory context "ExecutorState".

Что это значит

PostgreSQL выделяет память в контекстах. Когда операционная система отказывает в выделении, выполнение инструкции завершается с 53200 и DETAIL строка указывает размер запроса и контекст памяти. Журнал сервера получает дамп размеров контекста памяти, который показывает, куда ушла память.

На Linux с включённым перераспределением памяти (overcommit) OOM-killer ядра может вместо этого просто убить процесс PostgreSQL; сервер затем перезапускает все сессии, и соединения клиентов обрываются.

Распространённые причины

  • work_mem задан высоким и умножается на множество узлов сортировки и хеширования — в нескольких сессиях одновременно.
  • Запрос, возвращающий или агрегирующий огромное количество данных в одно значение, например array_agg или string_agg на миллионах строк.
  • Слишком много подключений для памяти машины.
  • Утечка памяти в расширении или очень большая maintenance_work_mem во время построения индексов.

Как исправить

  1. Прочитайте дамп контекста памяти в журнале сервера, чтобы увидеть, какой контекст увеличился.

  2. Снизьте work_mem глобально и повышайте его только для сессии, которой это необходимо.

    ALTER SYSTEM SET work_mem = '16MB';
    SELECT pg_reload_conf();
    -- for one heavy report:
    SET work_mem = '256MB';
  3. Проверьте план: нет ли там хэш-соединений и сортировок по гораздо большему числу строк, чем ожидалось, и исправьте оценки или добавьте индекс.

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. Ограничьте параллелизм с помощью пула подключений, а в Linux установите vm.overcommit_memory = 2 чтобы выделение памяти завершалось штатным отказом вместо срабатывания OOM-killer.

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.