// Référence des erreurs PostgreSQL

PostgreSQL 53200 : mémoire insuffisante

Un processus serveur n'a pas pu allouer de mémoire pour la requête. Le plus souvent, un tri ou un hachage démesuré, un très grand résultat construit en mémoire, ou trop de connexions occupées.

SQLSTATE
53200
Nom
out_of_memory
Catégorie
Ressources insuffisantes
Message d'erreur
out of memory
DETAIL:  Failed on request of size 1048576 in memory context "ExecutorState".

Ce que cela signifie

PostgreSQL alloue la mémoire par contextes. Lorsque le système d'exploitation refuse une allocation, l'instruction échoue avec 53200 et le DETAIL la ligne indique la taille de la requête et le contexte mémoire. Le journal du serveur contient un dump des tailles de contexte mémoire qui montre où est passée la mémoire.

Sur Linux avec sur-engagement de mémoire, l'OOM killer du noyau peut au contraire tuer net un processus PostgreSQL ; le serveur redémarre alors toutes les sessions, et les clients voient leurs connexions se couper.

Causes courantes

  • work_mem défini à une valeur élevée et multiplié par de nombreux nœuds de tri et de hachage, dans de nombreuses sessions à la fois.
  • Une requête retournant ou agrégeant une énorme quantité de données en une valeur, comme array_agg ou string_agg sur des millions de lignes.
  • Trop de connexions pour la mémoire de la machine.
  • Une fuite de mémoire dans une extension, ou un maintenance_work_mem pendant la création d'index.

Comment le corriger

  1. Lisez le vidage du contexte mémoire dans le journal du serveur pour voir quel contexte a grandi.

  2. Réduire work_mem globalement, et ne l'augmenter que pour la session qui en a besoin.

    ALTER SYSTEM SET work_mem = '16MB';
    SELECT pg_reload_conf();
    -- for one heavy report:
    SET work_mem = '256MB';
  3. Vérifiez le plan pour les jointures par hachage et les tris sur beaucoup plus de lignes que prévu, et corrigez les estimations ou ajoutez un index.

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. Limiter la concurrence avec un pool de connexions, et sur Linux, configurez vm.overcommit_memory = 2 pour que les allocations échouent proprement au lieu de déclencher l'OOM killer.

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.