dataiotech Labs
dbaguide.com · Senior DBA & SRE Diagnostic Standard v2.0
Home/Hata Kütüphanesi/POSTGRESQL/postgresql-temp-file-limit-exceeded-out-of-memory
PostgreSQL
PG 14 - 17SEVERITY: P1 HIGH
9 dk okuma
ERROR: temporary file size exceeds temp_file_limit / ERROR: out of memory

PostgreSQL Geçici Dosya Boyutu Aşımı ve Bellek Yetmezliği: work_mem Hesaplama, Sort/Hash Dökülmesi ve Sorgu İyileştirme

Aşırı yüksek work_mem x paralel sorgu çarpımı, disk sort/hash join dökülmesi ve temp_file_limit kısıtlamasının teşhisi, acil session müdahalesi ve güvenli bellek bütçesi formülü.

İnceleyen:Kıdemli Veritabanı Mimarı & SRE (dataiotech Labs)·2 Kasım 2026

Teshis & Ayırt Etme Protokolü (Disambiguation)

Ne Zaman Görülür?

POSTGRESQL depolama alanı, tablespace, disk hacmi veya bellek kotasının sınırına ulaştığını gösterir.

Ne Zaman Bu Hata DEĞİLDİR?

Yazılımsal sözdizimi veya tablo şema hatası değildir; fiziksel veya mantıksal kapasite yetersizliğidir.

Operasyonel Kanıt & Laboratuvar Doğrulaması

Gerçek veritabanı sürümlerinde test edilmiş teknik sınırlar ve güvenlik protokolü.

Laboratuvarda Doğrulandı
Test Edilen Sürümler

PostgreSQL 14.10, 15.6, 16.4, 17.11 (Alpine / Ubuntu 24.04)

Gerekli Yetki

SUPERUSER veya pg_read_all_stats

Risk & Etki Alanı
Hightemp_file_limit aşımı sorguyu abort eder; work_mem parametresini körlemesine yükseltmek OS OOM killer'ı tetikler
Geri Alma (Rollback)

temp_file_limit ve work_mem değerlerini varsayılan bütçeye çekme

Beklenen Çıktı & Doğrulama Kriteri

temp_bytes metriklerinin kontrol altına alınması ve sorguların disk yerine bellek içinde çalışması

Resmî Dokümantasyon Referansı

PostgreSQL Docs: Resource Consumption & temp_file_limit

Belgeyi Yeni Sekmede Aç
İlk 60 Saniye Teşhis Protokolü (Read-Only Safety Rule):

Hata mesajı bir semptomdur, kök neden değildir. Sunucuyu veya veritabanı servisini körü körüne yeniden başlatmayın! Önce aşağıdaki salt-okunur (read-only) teşhis sorgularını çalıştırarak gerçek arıza modunu tespit edin; ardından kontrollü müdahaleye geçin.

▸Belirti

Büyük bir raporlama sorgusu sırasında şu hata döner:

plaintext
ERROR: temporary file size exceeds temp_file_limit (10485760kB) ERROR: out of memory DETAIL: Failed on request of size 33554432 in memory context "ExecutorState".

▸Sahada Ne Görürsün?

Sorgu birkaç dakika çalıştıktan sonra hata verip düşer. pg_stat_database.temp_bytes metriği fırlar, disk G/Ç tavan yapar. Sistemde RAM yetersizliği varsa PostgreSQL process'i Linux OOM killer tarafından öldürülür.


▸Kök Neden Matrisi

OlasılıkKök NedenAçıklama
%50Büyük Sıralama (Disk Spill)ORDER BY veya Hash Join operasyonu work_mem sınırını aşıp diske taşmış, temp_file_limit tavanına vurmuştur.
%30Dengesiz `work_mem` x Concurrencywork_mem=256MB ayarlanmışken eşzamanlı 50 sorgu çalıştığında devasa RAM talep edilir ve OOM patlar.
%20Düşük temp_file_limitVeritabanı yöneticisi diskin dolmasını engellemek için çok katı kota koymuştur.

▸ACİL RUNBOOK (0-5dk)

sql
-- 1. Diske geçici dosya döken sorguları bul SELECT pid, usename, query, pg_size_pretty(temp_bytes) AS temp_size, temp_files FROM pg_stat_activity WHERE temp_bytes > 0 ORDER BY temp_bytes DESC; -- 2. Diski tüketen sorguyu durdur SELECT pg_cancel_backend(12345); -- 3. SADECE acil rapor oturumunda kotayı artır SET temp_file_limit = '20GB'; SET LOCAL work_mem = '256MB';

▸KALICI BLUEPRINT

  1. 1Güvenli `work_mem` Formülü:
📐 Formül:\text{work\_mem} = \frac{\text{Total RAM} \times 0.25}{\text{max\_connections} \times 2}
  1. 1Oturum Seviyesinde Yükseltme: Ağır batch sorgularda SET LOCAL work_mem = '128MB'; kullanılmalıdır.
  2. 2Loglama: log_temp_files = 10240 (10MB üstü logla).

▸Doğrulama

sql
SHOW work_mem; SHOW temp_file_limit; SELECT datname, temp_files, pg_size_pretty(temp_bytes) AS total_temp_bytes FROM pg_stat_database WHERE datname = current_database();
YENİ KONSEPTMÜHENDİSLİK BECERİSİ
Senior Mülakat Hazırlığı

POSTGRESQL Kapasite Planlaması, Otomatik Büyüme (Autogrowth) ve Bellek Yönetimi.

Bu hata yalnızca bir parametre eksikliği değil; veri tutarlılığı, concurrency mimarisi ve kapasite planlaması dersidir.

Öğrenme Hedefleri (Ölçülebilir Çıktılar):
  • Depolama doluluğunda acil alan açma prosedürlerini veri kaybı olmadan yürütmek.
  • Otomatik büyüme ve kota eşiklerini önceden izleme sistemine bağlamak.

Senior Mülakatında Bu Hatadan Ne Sorulur?

Q1Disk dolduğunda veritabanı motorunun crash olmasını önlemek için mimaride ne yapılmalıdır?
Mid
Senior Mühendis / Mimar Yanıtı:

Veri dosyaları, transaction loglar ve yedekleme dizinleri birbirinden bağımsız fiziksel disklere (LUN/volume) ayrılmalı, proaktif %80 disk uyarısı konmalıdır.

Q2Otomatik büyüme (autogrowth) adımının yüzde (%) yerine sabit MB/GB verilmesi neden önemlidir?
Senior
Senior Mühendis / Mimar Yanıtı:

Yüzdesel büyüme dosya büyüdükçe devasa blok tahsislerine yol açarak disk I/O kilitlenmelerine neden olur. Sabit boyut (örn. 512MB veya 1GB) öngörülebilir gecikme sağlar.

Q3Acil disk krizinde veritabanı dosyalarını doğrudan işletim sisteminden silmek neden felakettir?
Junior
Senior Mühendis / Mimar Yanıtı:

Veritabanı katalog metadata tutarlılığı bozulur, veritabanı SUSPECT veya RECOVERY FAILED durumuna düşer ve veri kaybı kaçınılmaz hale gelir.

Kıdemli DBA & SRE Kariyer Yol Haritası

Veritabanı güvenilirliği, kriz yönetimi ve mimarlık aşamalarını keşfedin.

Yol Haritasını İncele

POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar

Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.

Tümünü Gör
dbaguide.com · PostgreSQL ERROR: temp_file_limit Exceeded & Out of Memory Teşhisi · Kanıt Odaklı Teşhis Standardı
Son Güncelleme: 2 Kasım 2026 · Format v2.0