ERROR: temporary file size exceeds temp_file_limit / ERROR: out of memoryPostgreSQL 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ü.
Teshis & Ayırt Etme Protokolü (Disambiguation)
POSTGRESQL depolama alanı, tablespace, disk hacmi veya bellek kotasının sınırına ulaştığını gösterir.
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ü.
PostgreSQL 14.10, 15.6, 16.4, 17.11 (Alpine / Ubuntu 24.04)
SUPERUSER veya pg_read_all_stats
temp_file_limit ve work_mem değerlerini varsayılan bütçeye çekme
temp_bytes metriklerinin kontrol altına alınması ve sorguların disk yerine bellek içinde çalışması
PostgreSQL Docs: Resource Consumption & temp_file_limit
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:
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ık | Kök Neden | Açıklama |
|---|---|---|
| %50 | Bü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. |
| %30 | Dengesiz `work_mem` x Concurrency | work_mem=256MB ayarlanmışken eşzamanlı 50 sorgu çalıştığında devasa RAM talep edilir ve OOM patlar. |
| %20 | Düşük temp_file_limit | Veritabanı yöneticisi diskin dolmasını engellemek için çok katı kota koymuştur. |
▸ACİL RUNBOOK (0-5dk)
-- 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
- 1Güvenli `work_mem` Formülü:
- 1Oturum Seviyesinde Yükseltme: Ağır batch sorgularda
SET LOCAL work_mem = '128MB';kullanılmalıdır. - 2Loglama:
log_temp_files = 10240(10MB üstü logla).
▸Doğrulama
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();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.
- 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
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
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
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.
POSTGRESQL Hata Kütüphanesinden Diğer Başlıklar
Kriz anında başvurabileceğiniz diğer doğrulanmış teşhis rehberleri.
PostgreSQL Bağlantı Tükenmesi ve too many clients Teşhisi
FATAL: sorry, too many clients already ve remaining connection slots hatalarının üç temel kök nedeni, yetki sınırlarıyla salt okunur pg_stat_activity teşhisi ve kalıcı iki katmanlı havuzlama çözümü.
PostgreSQL password authentication failed Hatası: Neden ve Çözüm
psql password authentication failed hatasının dört nedeni: yanlış şifre, md5/SCRAM uyuşmazlığı, pg_hba.conf sırası ve yanlış cluster. Adım adım teşhis.
PostgreSQL connection refused: 8 Adımda Kesin Teşhis
Connection refused, timeout ve "no pg_hba.conf entry" arasındaki fark; listen_addresses, port, firewall ve Docker port yayınlama kontrolleri.