// 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 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. 檢查計畫中的雜湊聯結 (hash join) 與排序,是否處理遠多於預期的資料列,並修正估計值或新增索引。

    EXPLAIN (ANALYZE, BUFFERS) SELECT ...;
  4. 以連線集區限制並行數,並在 Linux 上設定 vm.overcommit_memory = 2 讓記憶體配置以乾淨的方式失敗,而不是觸發 OOM killer。

相關錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。