// 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 では、代わりにカーネルの OOM キラーが PostgreSQL プロセスを強制終了させることがあります。その場合、サーバーは全セッションを再起動し、クライアント側では接続が切れます。

よくある原因

  • work_mem 高く設定され、多数のソートノードとハッシュノードが複数セッションで同時に走ることで掛け合わされます。
  • 大量のデータを 1 つの値として返す、または集計するクエリ(例: 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 キラーを誘発する代わりに、メモリ割り当てはクリーンに失敗します。

関連エラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。