// PostgreSQL 錯誤參考

PostgreSQL 53100:磁碟已滿

存放資料目錄、WAL 或暫存檔案的檔案系統已滿。在空間釋放之前寫入都會失敗;WAL 磁碟寫滿可能導致伺服器停止。

SQLSTATE
53100
名稱
disk_full
類別
資源不足
錯誤訊息
could not extend file "base/16384/16397": No space left on device
HINT:  Check free disk space.

它的意義

PostgreSQL 獲得了 No space left on device 發生於擴增資料表或索引檔、寫入暫存排序檔或寫入 WAL 時,由作業系統回報。該陳述式會失敗並出現 53100(disk_full)而其交易已被回滾。

如果 WAL 目錄(pg_wal)被塞滿時,伺服器就無法寫入任何變更,並會以 PANIC 結束;空間釋放之前它無法再啟動。千萬別刪除 pg_wal 手動設定。

常見原因

  • 資料增長,或因大量更新與刪除卻未充分清理(vacuum)而膨脹的資料表與索引。
  • WAL 堆積是因為複製槽閒置、封存(archive_command)失敗,或 max_wal_size / wal_keep_size 很大。
  • 大型排序、雜湊或 CREATE INDEX 寫入暫存檔。
  • 同一磁碟區上的伺服器記錄或其他檔案。

如何修正

  1. 找出是什麼在佔用空間。

    SELECT pg_size_pretty(pg_database_size(current_database()));
    SELECT relname, pg_size_pretty(pg_total_relation_size(oid)) AS size
    FROM pg_class WHERE relkind = 'r'
    ORDER BY pg_total_relation_size(oid) DESC LIMIT 10;
  2. 找出拖住 WAL 的複寫槽,並移除不再使用的複寫槽。

    SELECT slot_name, active, pg_size_pretty(pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn)) AS retained
    FROM pg_replication_slots;
    SELECT pg_drop_replication_slot('old_slot');
  3. 確認 WAL 封存成功。

    SELECT archived_count, failed_count, last_failed_wal, last_failed_time FROM pg_stat_archiver;
  4. 釋放或增加磁碟空間:擴大磁碟區、移除不相干的檔案,或使用 VACUUM FULL (需要足以容納整個資料表副本的空間)或 pg_repack.

  5. 限制每個工作階段可使用的暫存檔,避免單一查詢塞滿磁碟。

    ALTER SYSTEM SET temp_file_limit = '20GB';
    SELECT pg_reload_conf();

相關錯誤

更多資源不足錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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